The following reference contains a list of global fields that have a well defined semantic meaning in Dynatrace and can be used across different monitoring types. The fields are organized in namespaces that are separated with dots.
The top level fields contain generally relevant information for all monitoring data
Attribute | Type | Description | Examples |
---|---|---|---|
timestamp | timestamp | stable The time (UNIX Epoch time in nanoseconds) when the event originated, typically when the source created it. If no original timestamp is available, it will be populated at ingest time and required for all events. In the case of a correlated event (for example, ITIL events), this time could be different from the event.start time, as this time represents the actual timestamp when the "update" for the event was created. | 1649822520123123123 |
timeframe | record[] | stable The timeframe represented by a timeseries record. | |
start_time | timestamp | stable Start time of a data point. Value is a UNIX Epoch time in nanoseconds and less or equal to the end_time . | 1649822520123123123 |
end_time | timestamp | stable End time of a data point. Value is a UNIX Epoch time in nanoseconds and greater or equal to the start_time . | 1649822520123123165 |
duration | duration | stable The difference between start_time and end_time in nanoseconds. | 42 |
interval | string | stable Denotes the timeframe of represented by individual timeseries measurements returned by a timeseries record. | 1 min |
Attribute | Type | Description | Examples |
---|---|---|---|
adobe.em.env_type | string | resource experimental Adobe Experience Manager (AEM) environment type. | dev ; stage ; prod |
adobe.em.program | string | resource experimental Adobe Experience Manager (AEM) service. Contains the customer defined name of the AEM environment. | |
adobe.em.service | string | resource experimental Adobe Experience Manager (AEM) service. Contains the program and environment IDs the customer is exposed to. | |
adobe.em.tier | string | resource experimental Adobe Experience Manager (AEM) tier. | author ; publish ; preview |
OneAgent might aggregate spans that have the same parent span into a single span. The aggregated span contains attributes to indicate the aggregation and to allow reconstructing details.
For aggregated spans the start_time
holds the earliest start_time
, end_time
holds the latest end_time
of all aggregated spans.
Attribute | Type | Description | Examples |
---|---|---|---|
aggregation.count | long | stable The number of spans aggregated into this span. Because this span represents multiple spans, the value is >1. | 3 |
aggregation.duration_max | duration | stable The duration in nanoseconds for the longest aggregated span. | 482 |
aggregation.duration_min | duration | stable The duration in nanoseconds for the shortest aggregated span. | 42 |
aggregation.duration_samples | duration[] | stable Array of reservoir sampled span durations of the aggregated spans. The duration samples can be used to estimate a more accurate duration distribution of aggregated spans rather than the average value. | [42, 482, 301] |
aggregation.duration_sum | duration | stable The duration sum in nanoseconds for all aggregated spans. | 123 |
aggregation.exception_count | long | stable The number of aggregated spans that included an exception. | 0 ; 6 |
aggregation.parallel_execution | boolean | stabletrue indicates that aggregated spans may have been executed in parallel. Therefore, start_time + duration_sum may exceed end_time . |
Attribute | Type | Description | Examples |
---|---|---|---|
apache.tomcat.base | string | resource experimental The server's base directory. This is what usually is referred to as CATALINA_BASE. | /usr/share/tomcat6 |
apache.tomcat.home | string | resource experimental The server's home directory. This is what usually is referred to as CATALINA_HOME. | /usr/share/tomcat6 |
Attribute | Type | Description | Examples |
---|---|---|---|
apache.httpd.config.path | string | resource experimental | |
apache.httpd.module.name | string | resource experimental The name of the Apache HTTP Server module that generated the log entry. | core ; proxy |
Attribute | Type | Description | Examples |
---|---|---|---|
apache.spark.master.ip | string | resource experimental |
The app namespace contains information on the application sending the event.
Attribute | Type | Description | Examples |
---|---|---|---|
app.bundle | string | resource stable The name of the bundle, for example the bundle identifier on iOS or the applicationId on Android. | com.example.easytravel |
app.id | string | resource stable An optional unique application identifier. Chosen by the customer | easytravel |
app.short_version | string | resource stable The application's publicly visible version number, as, for example, displayed in App Store or Google Play. Usually this is just the major and minor version with no patch number. | 5.23 |
app.version | string | resource stable The application's internal build number, which can include information such as patch number and build number. | 5.23.15789 ; 143542 |
The argocd
namespace contains Argo CD specific deployment attributes.
Attribute | Type | Description | Examples |
---|---|---|---|
argocd.app.health.status | string | experimental The health state of the tracked resource. 1 | Healthy ; Progressing ; Degraded ; Missing ; Suspended ; Unknown |
argocd.sync.operation_state.outcome | string | experimental Message associated with synchronization operation. 2 | successfully synced (no more tasks) ; Operation terminated (retried 4 times) |
argocd.sync.operation_state.phase | string | experimental Status of the synchronization operation between source and target. 3 | Running ; Succeeded ; Error ; Failed |
argocd.sync.status | string | experimental The sync status represents the current state of reconciliation. 4 | SYNCED ; OUT OF SYNC ; UNKNOWN |
The value is equal to the app.status.health.status
value in Argo CD.
The value is equal to the app.status.operationState.message
value in Argo CD.
The value is equal to the app.status.operationState.phase
value in Argo CD.
The value is equal to the app.status.sync.status
value in Argo CD.
The artifact
namespace contains information about software artifacts.
Attribute | Type | Description | Examples |
---|---|---|---|
artifact.attestation.filename | string | experimental The provenance filename of the built attestation. It directly relates to the artifact.filename . | carts-service-amd64-0.1.1.tar.gz.intoto.json1 |
artifact.attestation.hash | string | experimental The full hash value of the built attestation. | b4e370270ac4fe8d728b845ab8d190a7c931f09ff7b0156dd4d6abf797f1fe6a |
artifact.attestation.id | string | experimental The ID of the build software attestation. | 1337 |
artifact.filename | string | experimental The filename of the software artifact, typically generated by the build process. This is similar to the artifact.id , but can contain the artifact.version and other data like file extension. | carts-service-amd64-0.1.1.tar.gz |
artifact.hash | string | experimental The full hash value of the software artifact. This value is used to verify the integrity of the software artifact. | 6c323d126547f71fafb4bffa02cdc480fb284678644ef0b6c69029f051fe5137 |
artifact.id | string | experimental The identifier of the software artifact, typically the name of the artifact. | carts-service |
artifact.name | string | experimental The human-readable name of the software artifact. | Carts service |
artifact.purl | string | experimental The Package URL of the package artifact. This value is used to identify and locate the artifact. | pkg:npm/%40dynatrace/backstage@2.0.0 ; pkg:deb/debian/curl@7.50.3-1?arch=i386&distro=jessie |
artifact.version | string | experimental The version of the software artifact, typically in Semantic Versioning format. | 0.1.1 |
Attribute | Type | Description | Examples |
---|---|---|---|
aspnetcore.appl.path | string | resource experimental |
Fields that can come from audit logs.
Attribute | Type | Description | Examples |
---|---|---|---|
audit.action | string | stable Audited action. | Access to Azure Resource Manager ; New User Created ; User added to Group |
audit.identity | string | stable User name, service account name, or principal name that executes audited action. | name.surname@example.com |
audit.result | string | stable Result of the audited action. | Succeeded ; Failed |
audit.status | string | stable Status of the audited action. | Started ; In Progress ; Succeeded ; Failed ; Active ; Resolved |
audit.time | timestamp | experimental Timestamp of the audited action. | 16/01/2025, 10:34 AM |
Authentication type and method used to login to a Dynatrace system.
Attribute | Type | Description | Examples |
---|---|---|---|
authentication.client.id | string | experimental The OAuth2 client id if of type 'CLIENT_CREDENTIALS'. | dt0s02.UZCK6ENL.2YQ2A3DZUEISRJSUU5544J3SC3TMPXSEEMNA5HK7RW54SJ6XKLYGMWJNKL7B2DNH |
authentication.grant.type | string | experimental The grant type used during OAuth2 authentication. | AUTHORIZATION_CODE ; CLIENT_CREDENTIALS |
authentication.token | string | experimental The public token identifier of authentication.type 'TOKEN'. | dt0c01.AM4SEYKIBROBEJ2N3HAXZ4IX |
authentication.type | string | experimental The method of authentication. | OAUTH2 |
authentication.grant.type
MUST be one of the following:
Value | Description |
---|---|
AUTHORIZATION_CODE | The OAuth 2.0 "Authorization Code" grant type |
CLIENT_CREDENTIALS | The OAuth 2.0 "Client Credentials" grant type |
authentication.type
MUST be one of the following:
Value | Description |
---|---|
DEVOPSTOKEN | Authenticated via DevOps token |
NONE | Not authenticated (authentication not necessary) |
OAUTH2 | The OAuth 2.0 authentication type grant type |
TOKEN | Authenticated via API access token or personal access token |
authentication.client.id
and authentication.token
MUST follow the Dynatrace token format definition.
Specifically, authentication.client.id
MUST be prefixed with dt0s02.
Information about entity availability. Sample usage is reporting hosts and PGI-s availability by OS Agent. Value of availability.state can be used for calculating aggregate availability (dividing count of "successful" requests by count of all requests). With constant frequency of requests it can be treated as a time-base availability, showing percentage of time that the monitored entity was available.
Attribute | Type | Description | Examples |
---|---|---|---|
availability.state | string | stable State of entity (host or PGI) availability. | up |
availability.state
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
available | [PGI] PGI is available and reported. |
no_data | [HOST] Host is working, agent active but no data are sent. |
no_data_agent_inactive | [HOST] Host is working, agent inactive (disabled manually in configuration). No data are sent. |
reboot_graceful | [HOST] Host has started after graceful shutdown. |
reboot_ungraceful | [HOST] Host has started after ungraceful shutdown. |
shutdown_host | [HOST] Host has been shut down. |
unavailable | [PGI] PGI is unavailable and not reported. |
unimportant | [PGI] PGI is available but not reported because it became unimportant. |
unmonitored_agent_stopped | [HOST] Host is unmonitored because agent stopped. |
unmonitored_agent_uninstalled | [HOST] Host is unmonitored because agent has been uninstalled. |
unmonitored_agent_upgrade | [HOST] Host is unmonitored because agent is upgrading. |
up | [HOST] Host is working, agent active and sending data. |
Fields that can come from applications running on AWS.
Attribute | Type | Description | Examples |
---|---|---|---|
aws.account.id | string | resource stable The 12-digit number, such as 123456789012, that uniquely identifies an AWS account. Tags: permission primary-field | 123456789012 |
aws.account.name | string | resource experimental Name associated with the AWS account. | example.com |
aws.alb.name | string | resource experimental Application load balancer name that instance is behind. | my-alb |
aws.arn | string | resource experimental Amazon Resource Name (ARN). | arn:aws:lambda:us-east-1:478983378254:function:acceptanceWeatherBackend |
aws.availability_zone | string | resource experimental A specific availability zone or array of zones in given AWS region. | us‑east‑1a ; us‑east‑1b |
aws.availability_zone.id | string | resource experimental ID for the availability zone. | use1-az1 ; use1-az2 ; use1-az3 |
aws.cloudfront.detailed_result_type | string | resource experimental Extends the aws.cloudfront.result_type with additional states. See full list under x-edge-detailed-result-type. | OriginShieldHit ; MissGeneratedResponse ; InvalidRequest |
aws.cloudfront.response.result_type | string | resource experimental How the server classified the response just before returning the response to the viewer. | Hit ; Miss ; LimitExceeded |
aws.cloudfront.result_type | string | resource experimental How the server classified the response after the last byte left the server. | Hit ; Miss ; LimitExceeded |
aws.ecr.account.id | string | resource experimental | |
aws.ecr.region | string | resource experimental | |
aws.ecs.cluster | string | resource experimental | |
aws.ecs.container.arn | string | resource experimental The full Amazon Resource Name (ARN) of the container. | arn:aws:ecs:us-west-2:111122223333:container/05966557-f16c-49cb-9352-24b3a0dcd0e1 |
aws.ecs.container.name | string | resource experimental | |
aws.ecs.docker.id | string | resource experimental The Docker ID for the container. | cd189a933e5849daa93386466019ab50-2495160603 |
aws.ecs.docker.name | string | resource experimental The name of the container supplied to Docker. | curl-image |
aws.ecs.family | string | resource experimental | |
aws.ecs.revision | string | resource experimental | |
aws.ecs.task.arn | string | resource experimental The full Amazon Resource Name (ARN) of the task to which the container belongs. | arn:aws:ecs:us-west-2:111122223333:task/default/cd189a933e5849daa93386466019ab50 |
aws.execution_environment | string | resource experimental The runtime identifier, prefixed by AWS_Lambda_. Lambda supports multiple languages through the use of runtimes. A runtime provides a language-specific environment that relays invocation events, context information, and responses between Lambda and the function. | AWS_Lambda_java8 |
aws.fle.fields_number | long | resource experimental The number of field-level encryption fields that the server encrypted and forwarded to the origin. | 12 ; 27 |
aws.fle.status | string | resource experimental When field-level encryption is configured for a distribution, this field contains a code that indicates whether the request body was successfully processed. | FieldLengthLimitClientError |
aws.lambda.function.name | string | resource experimental | |
aws.lambda.initialization_type | string | resource experimental The AWS Lambda initialization type. Same string value as available in AWS_LAMBDA_INITIALIZATION_TYPE. | snap_start |
aws.log_group | string | resource experimental Amazon CloudWatch group of log streams that share the same retention, monitoring, and access control settings. | /aws/lambda/a-SomeFumction-1AWHD6W1QC5DH |
aws.log_stream | string | resource experimental A sequence of log events that share the same source. | 2021/01/04/[$LATEST]b2e34f11da04232cb9f9d3d5799a5c12 |
aws.region | string | resource stable A specific geographical AWS Cloud location. Tags: primary-field | us-east-1 |
aws.resource.id | string | resource experimental Unique, immutable, identifier assigned to the Azure cloud resource. | i-0922cda4579db3a45 |
aws.resource.name | string | resource experimental Name of the resource (value of the "Name" tag in AWS). | my-ec2-instance |
aws.resource.type | string | resource experimental The name of a resource type. | group ; cluster ; instance |
aws.service | string | resource experimental The service that identifies the AWS product. | s3 |
aws.tags.__tag_key__ | string | resource experimental Contains the value for the tag with the tag key named __tag_key__ defined in the tag enrichment configuration. | dt_owner_mail |
aws.fle.status
MUST be one of the following:
Value | Description |
---|---|
FieldLengthLimitClientError | A field that is configured to be encrypted exceeds the maximum length allowed. |
FieldNumberLimitClientError | A request that the distribution is configured to encrypt contains more than the number of fields allowed. |
ForwardedByContentType | The server forwarded the request to the origin without parsing or encryption because no content type was configured. |
ForwardedByQueryArgs | The server forwarded the request to the origin without parsing or encryption because the request contains a query argument that wasn't in the configuration for field-level encryption. |
ForwardedDueToNoProfile | The server forwarded the request to the origin without parsing or encryption because no profile was specified in the configuration for field-level encryption. |
MalformedContentTypeClientError | The server rejected the request and returned an HTTP 400 status code to the viewer because the value of the Content-Type header was in an invalid format. |
MalformedInputClientError | The server rejected the request and returned an HTTP 400 status code to the viewer because the request body was in an invalid format. |
MalformedQueryArgsClientError | The server rejected the request and returned an HTTP 400 status code to the viewer because a query argument was empty or in an invalid format. |
Processed | The server successfully processed the request body, encrypted values in the specified fields, and forwarded the request to the origin. |
RejectedByContentType | The server rejected the request and returned an HTTP 400 status code to the viewer because no content type was specified in the configuration for field-level encryption. |
RejectedByQueryArgs | The server rejected the request and returned an HTTP 400 status code to the viewer because no query argument was specified in the configuration for field-level encryption. |
RequestLengthLimitClientError | The length of the request body exceeded the maximum length allowed when field-level encryption is configured. |
ServerError | The origin server returned an error. |
aws.lambda.initialization_type
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
on-demand | On demand |
provisioned-concurrency | Provisioned concurrency |
snap-start | SnapStart |
Attribute | Type | Description | Examples |
---|---|---|---|
aws.kinesis.arn | string | experimental Amazon resource name (ARN) of a Kinesis stream or consumer. | arn:aws:kinesis:us-east-2:123456789012:stream/MyKinesisStream ; arn:aws:kinesis:us-west-2:123456789012:stream/MyKinesisStream/consumer/MyKinesisConsumer:1616044553 |
aws.kinesis.consumer.arn | string | experimental Amazon resource name (ARN) of a Kinesis consumer. | arn:aws:kinesis:us-west-2:123456789012:stream/MyKinesisStream/consumer/MyKinesisConsumer:1616044553 |
aws.kinesis.consumer.name | string | experimental Name of a Kinesis consumer. | MyKinesisConsumer |
aws.kinesis.stream.arn | string | experimental Amazon resource name (ARN) of a Kinesis stream. | arn:aws:kinesis:us-east-2:123456789012:stream/MyKinesisStream |
aws.kinesis.stream.name | string | experimental Name of a Kinesis stream. | MyKinesisStream |
aws.lambda.invoked_arn | string | experimental The full invoked ARN as provided on the Context passed to the function (Lambda-Runtime-Invoked-Function-Arn response header from the request to /runtime/invocation/next ). | arn:aws:lambda:us-east-1:123456789012:function:acceptanceWeatherBackend:production |
aws.request_id | string | experimental The AWS request ID (e.g., value of x-amzn-requestid , x-amzn-request-id , or x-amz-request-id HTTP header, awsRequestId field in AWS lambda context object). | 0e7bc729-a468-57e8-8143-98f2eec5c925 |
aws.s3.bucket | string | experimental Name of an S3 bucket. | amzn-s3-demo-bucket ; amzn-s3-demo-bucket1-a1b2c3d4-5678-90ab-cdef-example11111 |
aws.s3.key | string | experimental Key name of the object. | Development/Projects.xls ; Finance/statement1.pdf ; s3-dg.pdf |
aws.s3.object_version | string | experimental Version ID for the specific version of the object. | 3sL4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nr8X8gdRQBpUMLUo |
aws.s3.part_number | long | experimental Part number in a multi-part upload. | 3456 |
aws.s3.source.bucket | string | experimental Name of the bucket containing the object to copy. | amzn-s3-source-bucket |
aws.s3.source.key | string | experimental Key of the object to copy. | Finance/statement1.pdf |
aws.s3.source.object_version | string | experimental Version of the source object to copy. By default, the latest version is copied. | 3sL4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nr8X8gdRQBpUMLUo |
aws.s3.upload_id | string | experimental Upload ID identifying the multipart upload targeted by an operation (abort/complete/upload/…). | dfRtDYWFbkRONycy.Yxwh66Yjlx.cph0gtNBtJ |
aws.xray.trace_id | string | experimental Contains the AWS X-Ray trace id (e.g., value of the x-amzn-trace-id HTTP header, _X_AMZN_TRACE_ID environment variable on AWS lambda) | Root=1-63441c4a-abcdef012345678912345678 ; Self=1-63441c4a-12456789abcdef012345678;Root=1-67891233-abcdef012345678912345678 |
Fields that can come from applications running on Azure.
Attribute | Type | Description | Examples |
---|---|---|---|
azure.availability_zones | string[] | resource experimental Availability zones of Azure Cloud resource. | [1] |
azure.class_name | string | resource experimental The fully qualified name of the class executing an Azure function. | Host.Functions |
azure.container_app.dnssuffix | string | resource experimental The DNS suffix for the Container Apps environment. | redbeach-0f8a3e63.northeurope.azurecontainerapps.io |
azure.container_app.hostname | string | resource experimental The revision-specific hostname of the container app. | kapitan-bomba-demo--nk4tc46.redbeach-0f8a3e63.northeurope.azurecontainerapps.io |
azure.container_app.name | string | resource experimental The name of the container app. | kapitan-bomba-demo |
azure.container_app.replica.name | string | resource experimental The name of the container app replica. | kapitan-bomba-demo--nk4tc46-5d568c5df6-49px7 |
azure.event_hub_namespace.name | string | resource experimental Azure Event Hub Namespace name. | my-event-hub |
azure.location | string | resource stable A specific geographical location of Azure Cloud resource. Tags: primary-field | westeurope |
azure.management_group | string | resource experimental A group of Azure subscriptions used for governance use cases. | Tenant Root Group ; My Custom Group |
azure.resource.group | string | resource stable A resource group is a container that holds related resources for an Azure solution. Tags: permission primary-field | demo-backend-rg |
azure.resource.id | string | resource experimental A unique, immutable identifier assigned to each Azure cloud resource. | /subscriptions/27e9b03f-04d2-2b69-b327-32f433f7ed21/resourceGroups/demo-backend-rg/providers/Microsoft.ContainerService/managedClusters/demo-aks |
azure.resource.name | string | resource experimental User-provided name of the Azure cloud resource. | demo-aks |
azure.resource.type | string | resource experimental The name of a resource type in the format: {resource-provider}/{resource-type}. | Microsoft.ContainerService/managedClusters |
azure.service_bus_namespace.name | string | resource experimental Azure Service Bus name. | my-service-bus |
azure.site_name | string | resource experimental Globally unique deployment information about an Azure function. | dt-function-scripted |
azure.sql_elastic_pool.name | string | resource experimental Azure SQL Server Elastic Pool name. | contoso-elastic-pool |
azure.sql_server.name | string | resource experimental Azure SQL Server name. | contoso-sql-server |
azure.subscription | string | resource stable An Azure subscription is a logical container used to provision resources in Azure. Tags: permission primary-field | 27e9b03f-04d2-2b69-b327-32f433f7ed21 |
azure.tags.__tag_key__ | string | resource experimental Contains the value for the tag with the tag key named __tag_key__ defined in the tag enrichment configuration. | dt_owner_mail |
azure.tenant.id | string | resource experimental Unique, immutable identifier assigned to the Azure tenant. | 37c4add3-612a-483d-8b24-cccbb35d3306 |
azure.tenant.name | string | resource experimental Name assigned to the Azure tenant. | MyAzureTenant |
azure.vm.name | string | resource experimental Azure Virtual Machine name. | my-virtual-machine |
azure.vm_scale_set.name | string | resource experimental Azure Virtual Machine Scale Set name. | my-vmss |
azure.vmid | string | resource experimental Azure Virtual Machine unique 128bits identifier | 090556DA-D4FA-764F-A9F1-63614EDA019A |
Attribute | Type | Description | Examples |
---|---|---|---|
bizflow.id | string | experimental Internal ID from the business flow configured in the Business Flow app. | |
bizflow.priority | string | experimental The priority of a business process. | critical ; high ; medium ; low |
bizflow.url | string | experimental URL to explore the business flow in the Business Flow app from a result in a DQL query against Smartscape nodes. |
Fields that are integral to applications managed by BOSH.
Attribute | Type | Description | Examples |
---|---|---|---|
bosh.availability_zone | string | resource experimental A specific geographical BOSH location. | us-east-1a |
bosh.deployment.id | string | resource stable BOSH depoloyment ID, retrievied from /var/vcap on monitored host. | cf-c32ffe771e4ad26b9711 |
bosh.instance.name | string | resource stable BOSH instance name, retrievied from /var/vcap on monitored host. | diego_database |
bosh.instance_id | string | resource experimental A unique identifier assigned to each deployed instance. | af318409-9e9d-4a18-aca4-0fb52bbdc526 |
bosh.name | string | resource experimental A unique identifier to a deployment or instance. | isolated_diego_cell_devima |
bosh.stemcell.version | string | resource stable Version of BOSH stemcell, retrievied from /var/vcap on monitored host. | 621.448 |
The browser namespace contains information on the browser running an application.
Attribute | Type | Description | Examples |
---|---|---|---|
browser.frame.id | uid | experimental A unique ID generated by RUM JavaScript to identify the browser frame. The browser.frame.id is an 8-byte ID and hex-encoded if shown as a string. | f76281848bd8288c |
browser.frame.parent_id | uid | experimental A unique ID generated by RUM JavaScript to identify the browser's next-higher frame (if that frame exists and is reachable). The browser.frame.parent_id is an 8-byte ID and hex-encoded if shown as a string. | f76281848bd8288c |
browser.tab.id | uid | experimental A unique ID generated by RUM JavaScript to identify the browser tab. The browser.tab.id is an 8-byte ID and hex-encoded if shown as a string. | f76281848bd8288c |
browser.window.device_pixel_ratio | double | experimental The ratio of the resolution in physical pixels to the resolution in CSS pixels for the current display device. | 1.0 |
browser.window.height | long | experimental The browser window's inner height, in pixels. | 384 |
browser.window.width | long | experimental The browser window's inner width, in pixels. | 2048 |
Attribute | Type | Description | Examples |
---|---|---|---|
browser.name | string | resource stable The browser name. | Mozilla |
browser.type | string | resource stable The browser type. | desktop ; mobile ; tablet ; robot ; other |
browser.user_agent | string | resource stable The full user agent string as provided by the browser in the HTTP User-Agent request header. | Mozilla/5.0 (Windows NT 10.0; Win64; x64) |
browser.version | string | resource stable The browser version. | 5.0 |
Span scoped attributes (e.g. method parameters, return values, class names, …) captured by the OneAgent based on a request attribute rule. The actual name of the attribute is the prefix "captured_attribute" plus the "request attribute name" defined in the request attributes configuration. In contrast to request attributes, captured attributes contain the raw values reported by the OneAgent at the location (i.e. on the active span) where they appeared. No aggregation (first/last value, distinct values, ...), type conversion or normalization is performed on them. They are the basis for request attributes.
Attribute | Type | Description | Examples |
---|---|---|---|
captured_attribute.__attribute_name__ | array | stable Contains the span scoped raw values that were captured under the name __attribute_name__ defined by the request attribute configuration. The values are mapped as an array according to the type of the captured attributes, so either boolean, double, long, or string. If the captured attributes have mixed types (e.g. long and string, or double and long, etc.), all attributes are converted to string and stored as string array. | [42] ; ['Platinum'] ; [32, 16, 8] ; ['Special Offer', '1702'] ; ['18.35', '16'] |
Attribute | Type | Description | Examples |
---|---|---|---|
cassandra.cluster.name | string | resource experimental |
The cicd
namespace contains information about Continuous Integration and Continuous Deployment systems.
Attribute | Type | Description | Examples |
---|---|---|---|
cicd.deployment.id | string | experimental The identifier of the deployment. | 1337 |
cicd.deployment.name | string | experimental The name of the deployment. | deploy frontend app ; deploy cart service |
cicd.deployment.namespace | string | experimental The destination namespace where the deployment resource is created. | default |
cicd.deployment.release_stage | string | experimental The name of the deployment environment, also known as deployment tier. | development ; staging ; production |
cicd.deployment.server.url.full | string | experimental The deployment server URL. | https://kubernetes.default.svc |
cicd.deployment.service.id | string | experimental The identifier of the service that is deployed. | 92ba59d6-379e-4ffd-a67e-d544a9c24dea |
cicd.deployment.status | string | experimental The status of the deployment. | failed ; succeeded |
cicd.pipeline.id | string | experimental The CI/CD pipeline's identifier, which is unique within one CI/CD system. | 12345 |
cicd.pipeline.name | string | experimental The human-readable name of the CI/CD pipeline. | CI pipeline for main branch |
cicd.pipeline.run.id | string | experimental An identifier for a pipeline run, which is unique within one CI/CD system. | 9876 |
cicd.pipeline.run.outcome | string | experimental The outcome of one pipeline run. | success |
cicd.pipeline.run.queued.duration | duration | experimental How long was the pipeline run queued before it was started, in nanoseconds. | 1234 |
cicd.pipeline.run.url.full | string | experimental The URL pointing to one specific pipeline run. | https://github.com/ACME/ACME-repo/actions/runs/9876 |
cicd.pipeline.url.full | string | experimental The CI/CD pipeline's full URL. | https://github.com/ACME/ACME-repo/actions/workflows/ci-build.yml |
cicd.upstream_pipeline.id | string | experimental The identifier of the upstream CI/CD pipeline. If a pipeline run was triggered by another pipeline, this attribute is used to reference the triggering pipeline. | 12345 |
cicd.upstream_pipeline.run.id | string | experimental The identifier of the upstream CI/CD pipeline run. If a pipeline run was triggered by another pipeline, this attribute is used to reference the triggering pipeline run. | 1337 |
cicd.deployment.status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
failed | The deployment failed. |
succeeded | The deployment succeeded. |
cicd.pipeline.run.outcome
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
canceled | The pipeline run was canceled and did not complete. |
error | The pipeline run failed with an error. |
failure | The pipeline run failed. |
skipped | The pipeline did not run, but was skipped. |
success | The pipeline run completed successfully. |
timed_out | The pipeline run timed out, and therefore did not complete. |
warning | The pipeline run completed with at least one warning. |
The client namespace contains information on the initiator of a network connection.
When observered from the server side, and when communicating through an intermediary,
client.ip
and client.port
typically represent the client information behind any intermediaries (such as proxies) if it's available.
Attribute | Type | Description | Examples |
---|---|---|---|
client.address | string | experimental Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. | client.example.com ; 10.1.2.80 ; [local] |
client.app.name | string | experimental The name of the client application used to perform the request. | MS Outlook |
client.ip | ipAddress | experimental The IP address of the client that makes the request. This may be IPv4 or IPv6. Tags: sensitive-spans | 194.232.104.141 ; 2a01:468:1000:9::140 |
client.ip.is_public | boolean | experimental Indicates whether IP is a public IP. | true |
client.isp | string | experimental The name of the Internet Service Provider (ISP) associated with the client's IP address. | Internet Service Provider Name |
client.port | long | stable Client port number. | 65123 ; 80 |
Fields related to cloud deployments that can be used across different providers.
Attribute | Type | Description | Examples |
---|---|---|---|
cloud.account.id | string | resource stable The cloud account ID to which the resource is assigned. | 111111111111 ; opentelemetry |
cloud.availability_zone | string | resource stable Identifier referring to the availability zone within a cloud vendor's region. | us-east-1a |
cloud.platform | string | resource stable The cloud platform in use. 1 | alibaba_cloud_ecs |
cloud.provider | string | resource experimental Name of the cloud provider. | alibaba_cloud |
cloud.region | string | resource stable Identifier of the cloud vendor's data center geographic region. | us-east-1 |
cloud.resource_id | string | resource stable Cloud provider-specific native identifier of the monitored cloud resource (for example, an ARN on AWS, a fully qualified resource ID on Azure, or a complete resource name on GCP). | arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function ; //run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID ; /subscriptions/<SUBSCIPTION_GUID>/resourceGroups/<RG>/providers/Microsoft.Web/sites/<FUNCAPP>/functions/<FUNC> |
The prefix of the service matches the one specified in cloud.provider
.
cloud.platform
MUST be one of the following:
Value | Description |
---|---|
alibaba_cloud_ecs | Alibaba Cloud Elastic Compute Service |
alibaba_cloud_fc | Alibaba Cloud Function Compute |
alibaba_cloud_openshift | Red Hat OpenShift on Alibaba Cloud |
aws_app_runner | AWS App Runner |
aws_ec2 | AWS Elastic Compute Cloud |
aws_ecs | AWS Elastic Container Service |
aws_eks | AWS Elastic Kubernetes Service |
aws_elastic_beanstalk | AWS Elastic Beanstalk |
aws_lambda | AWS Lambda |
aws_openshift | Red Hat OpenShift on AWS (ROSA) |
azure_aks | Azure Kubernetes Service |
azure_app_service | Azure App Service |
azure_container_instances | Azure Container Instances |
azure_functions | Azure Functions |
azure_openshift | Azure Red Hat OpenShift |
azure_vm | Azure Virtual Machines |
gcp_app_engine | Google Cloud App Engine (GAE) |
gcp_cloud_functions | Google Cloud Functions (GCF) |
gcp_cloud_run | Google Cloud Run |
gcp_compute_engine | Google Cloud Compute Engine (GCE) |
gcp_kubernetes_engine | Google Cloud Kubernetes Engine (GKE) |
gcp_openshift | Red Hat OpenShift on Google Cloud |
ibm_cloud_openshift | Red Hat OpenShift on IBM Cloud |
tencent_cloud_cvm | Tencent Cloud Cloud Virtual Machine (CVM) |
tencent_cloud_eks | Tencent Cloud Elastic Kubernetes Service (EKS) |
tencent_cloud_scf | Tencent Cloud Serverless Cloud Function (SCF) |
cloud.provider
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
alibaba_cloud | Alibaba Cloud |
aws | Amazon Web Services |
azure | Microsoft Azure |
gcp | Google Cloud Platform |
heroku | Heroku Platform as a Service |
ibm_cloud | IBM Cloud |
tencent_cloud | Tencent Cloud |
Fields related to operations related to a cloud.
The cloud.target
namespace provides information on the entity targeted by outgoing requests.
Attribute | Type | Description | Examples |
---|---|---|---|
cloud.target.account.id | string | experimental The cloud account ID used to access a cloud resource. | 111111111111 ; 984398786124 |
cloud.target.provider | string | experimental Name of the cloud provider. | alibaba_cloud |
cloud.target.region | string | experimental Identifier of the cloud vendor's data center geographic region. | us-east-1 |
cloud.target.resource_id | string | experimental Cloud provider-specific native identifier of the accessed cloud resource (for example, an ARN on AWS, a fully qualified resource ID on Azure, or a complete resource name on GCP). If the value is not directly extractable for instrumentation, it can be constructed from its components. | arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function ; //run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID ; /subscriptions/<SUBSCIPTION_GUID>/resourceGroups/<RG>/providers/Microsoft.Web/sites/<FUNCAPP>/functions/<FUNC> |
cloud.target.provider
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
alibaba_cloud | Alibaba Cloud |
aws | Amazon Web Services |
azure | Microsoft Azure |
gcp | Google Cloud Platform |
heroku | Heroku Platform as a Service |
ibm_cloud | IBM Cloud |
tencent_cloud | Tencent Cloud |
The cloud.origin
namespace provides information on the entity from which incoming requests originate.
Attribute | Type | Description | Examples |
---|---|---|---|
cloud.origin.account.id | string | experimental The cloud account ID used to access a cloud resource. | 111111111111 ; 984398786124 |
cloud.origin.provider | string | experimental Name of the cloud provider. | alibaba_cloud |
cloud.origin.region | string | experimental Identifier of the cloud vendor's data center geographic region. | us-east-1 |
cloud.origin.resource_id | string | experimental Cloud provider-specific native identifier of the accessed cloud resource (for example, an ARN on AWS, a fully qualified resource ID on Azure, or a complete resource name on GCP). If the value is not directly extractable for instrumentation, it can be constructed from its components. | arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function ; //run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID ; /subscriptions/<SUBSCIPTION_GUID>/resourceGroups/<RG>/providers/Microsoft.Web/sites/<FUNCAPP>/functions/<FUNC> |
cloud.origin.provider
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
alibaba_cloud | Alibaba Cloud |
aws | Amazon Web Services |
azure | Microsoft Azure |
gcp | Google Cloud Platform |
heroku | Heroku Platform as a Service |
ibm_cloud | IBM Cloud |
tencent_cloud | Tencent Cloud |
Attribute | Type | Description | Examples |
---|---|---|---|
cloudfoundry.application.id | string | resource experimental | |
cloudfoundry.application.name | string | resource experimental | |
cloudfoundry.instance.index | string | resource experimental | |
cloudfoundry.space.id | string | resource experimental | |
cloudfoundry.space.name | string | resource experimental |
Attribute | Type | Description | Examples |
---|---|---|---|
code.call_stack | string | experimental The call stack of the code.function . The call stack starts with the code.function , and the stack frames are separated by a line feed. | com.example.SampleClass.doProcessing(SampleClass.java) com.example.SampleClass.doSomeWork(SampleClass.java) com.example.SampleClass.main(SampleClass.java) |
code.filepath | string | experimental The source code file name that identifies the code unit as uniquely as possible. | /usr/local/MyApplication/content_root/app/index.php |
code.function | string | experimental The method or function name, or equivalent (usually the rightmost part of the code unit's name). Represents the name of the function that is represented by this span. | serveRequest |
code.invoked.filepath | string | experimental Like code.filepath , only it represents the file path of the function that was active when a span has been started. Typically, it is the function that has been instrumented. It should only be set if it differs from code.filepath . | /usr/local/MyApplication/content_root/app/index.php |
code.invoked.function | string | experimental Like code.function , only it represents the function that was active when a span has been started. Typically, it's the function that has been instrumented. The spans duration does not reflect the duration of this function execution. It should only be set if it differs from code.function . | invoke |
code.invoked.namespace | string | experimental Like code.namespace , only it represents the namespace of the function that was active when a span has been started. Typically, it's the function that has been instrumented. It should only be set if it differs from code.namespace . | com.sun.xml.ws.server.InvokerTube$2 |
code.line.number | long | experimental The line number within the source code file. | 1337 |
code.namespace | string | experimental The namespace within which code.function is defined. Usually, the qualified class or module name, such that code.namespace + some separator + code.function forms a unique identifier for the code unit. | com.example.MyHttpService |
Attribute | Type | Description | Examples |
---|---|---|---|
coldfusion.jvm.config.file | string | resource experimental | |
coldfusion.service.name | string | resource experimental |
For some technologies compilation of code might be a significant contributor to request execution time. Compilation timings provide insight into this, where available.
Attribute | Type | Description | Examples |
---|---|---|---|
compilation_timings.compilation_count | long | experimental The number of compilations contributing to compilation_timings.duration_sum . | 7 |
compilation_timings.duration_sum | duration | experimental The total duration in nanoseconds spent compiling. | 6723 |
compilation_timings.top_compilations | record | experimental The top N compilations contributing to compilation_timings.duration_sum , represented as map from compilation unit name to duration in nanoseconds spent. | {'/home/user/test/php/build/tmp/php-htdocs/memcached/memcachedCli.php': 1952, '/home/user/test/php/build/tmp/php-htdocs/curl_cli_uri_filtering.php': 1306} |
Attribute | Type | Description | Examples |
---|---|---|---|
container.id | string | resource experimental Container ID. Usually a UUID, as for example used to identify Docker containers. The UUID might be abbreviated. | a3bf90e006b2 |
container.image.name | string | resource experimental Name of the image the container was built on. | gcr.io/opentelemetry/operator |
container.image.version | string | resource experimental | 0.1 |
container.name | string | resource experimental Container name used by container runtime. | opentelemetry-autoconf |
CTG (shorthand for "CICS Transaction Gateway") is a connector for enterprise modernization of CICS assets. It empowers various application platforms, such as Java servlets, to incorporate CICS programs.
CICS (shorthand for "Customer Information Control System") is a middleware to support rapid, high-volume online transaction processing on IBM mainframe systems on z/OS. CTG features a client and a server, which communicate via so-called GatewayRequests.
Attribute | Type | Description | Examples |
---|---|---|---|
ctg.request.call_type | long | experimental Integer representing the call type of the CTG GatewayRequest. The set of possible values varies per request type. 1 | 2 |
ctg.request.commarea_length | long | experimental Length of the COMMAREA. Only set when the request type is ECI. | 0 |
ctg.request.extend_mode | long | experimental Integer representing the extended mode of the CTG GatewayRequest. Only set when the request type is ECI. 2 | 11 |
ctg.request.flow_type | long | experimental Integer representing the flow type of the CTG GatewayRequest. 3 | 5 |
ctg.request.gateway_url | string | experimental URL of the gateway. Only set on client-side spans. | tcp://1.2.3.4:5678/ |
ctg.request.object_name | string | experimental Name of the request object. Only set when the request type is ADMIN. | |
ctg.request.server_id | string | experimental ID of the server. Not set for all request types. | IPICTEST |
ctg.request.term_id | string | experimental Name of the terminal resource. Only set when the request type is EPI. | CN02 |
ctg.request.type | string | experimental Type of the CTG GatewayRequest. | BASE |
ctg.response.code | long | experimental CTG response code. The set of possible values varies per request type. 4 | -23 |
The values are defined in the IBM CTG API source code.
ctg.request.type
MUST be one of the following:
Value | Description |
---|---|
ADMIN | Admin request. |
AUTH | Authentication request. |
BASE | Base. A base GatewayRequest without a further subtype. 1 |
ECI | External Call Interface. Enables a client application to call a CICS program synchronously or asynchronously. 2 |
EPI | External Presentation Interface. Enables a user application to install a virtual IBM 3270 terminal into a CICS server. 3 |
ESI | External Security Interface. Enables user applications to perform security-related tasks. 4 |
XA | CICS Request Exit. It can be used for request retry, dynamic server selection, and rejecting non-valid requests. 5 |
Attribute | Type | Description | Examples |
---|---|---|---|
custom_service.method | string | experimental The service method of a custom service. This field only exists if a custom service was created via Dynatrace OneAgent SDK. | startTask ; run ; authenticate |
custom_service.name | string | experimental The name of a custom service. This field only exists if a custom service was created via Dynatrace OneAgent SDK. | MyCustomService ; AuthenticationComponent |
Attribute | Type | Description | Examples |
---|---|---|---|
db.affected_item_count | long | experimental The number of items (rows, documents,…) affected. | 32 |
db.collection.name | string | stable The name of a collection (table, container) within the database. | customers ; public.users |
db.connection_string | string | experimental The connection string for a database connection. Tags: sensitive-spans | jdbc:dynamodb:Access Key=XXX;Secret Key=XXX;Domain=amazonaws.com;Region |
db.cosmosdb.request_charge | double | experimental The cost of the request in Azure Cosmos DB request units (RU). | 4.95 ; 2.0 |
db.dynamodb.table_names | string[] | experimental The list of tables the request targets. | [Cats, Dogs] |
db.namespace | string | stable The name of the database, fully qualified within the server address and port. | customers ; test.users |
db.operation.name | string | stable The name of the operation or command executed, for example the MongoDB command name, SQL keyword, Redis command name,… 1 | drop ; findAndModify ; SELECT ; PREPARE ; GetItem ; set ; LPUSH ; mutateIn ; ReadItems |
db.query.parameters | record[] | experimental The query parameters used in db.query.text represented as a key and value map. For database systems without named keys, the map key is the string representation of the index starting with 0. Several database requests may get aggregated into a single span. Each entry in the array holds the bind parameters for one database request. Tags: sensitive-spans | [{'name': 'paul', 'age': '23'}, {'name': 'mary', 'age': '32'}] ; [{'0': 'paul', '1': '23'}, {'0': 'mary', '1': '32'}] |
db.query.text | string | stable The database query being executed. 2 | SELECT * FROM wuser_table ; SET mykey "WuValue" |
db.result.duration_max | duration | experimental The maximum duration in nanoseconds used for fetching the result. | 345 |
db.result.duration_min | duration | experimental The minimum duration in nanoseconds used for fetching the result. | 123 |
db.result.duration_sum | duration | experimental The total duration in nanoseconds used for fetching the result. | 234 |
db.result.exception_count | long | experimental The number of exceptions encountered while fetching the result. | 2 |
db.result.execution_count | long | experimental The number of operations executed on the result (for example, fetches from SQL result set, MongoDB cursor operations). | 12 |
db.result.roundtrip_count | long | experimental The number of round-trips triggered by fetching the result. | 2 |
db.system | string | experimental An identifier for the database management system (DBMS) product being used. See below for a list of well-known identifiers. | mongodb ; mysql |
Depending on the data provided on ingest, this attribute may be derived by e.g., parsing db.query.text
. Parsing might fail, or the result might be inaccurate.
The value may be sanitized to exclude sensitive information.
db.system
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
adabas | Adabas (Adaptable Database System) |
cache | InterSystems Caché |
cassandra | Apache Cassandra |
clickhouse | ClickHouse |
cloudscape | Cloudscape |
cockroachdb | CockroachDB |
coldfusion | ColdFusion IMQ |
cosmosdb | Microsoft Azure Cosmos DB |
couchbase | Couchbase |
couchdb | CouchDB |
db2 | IBM Db2 |
derby | Apache Derby |
dl/i | IBM DL/I |
dynamodb | Amazon DynamoDB |
edb | EnterpriseDB |
elasticsearch | Elasticsearch |
filemaker | FileMaker |
firebird | Firebird |
firstsql | FirstSQL |
geode | Apache Geode |
h2 | H2 |
hanadb | SAP HANA |
hbase | Apache HBase |
hive | Apache Hive |
hsqldb | HyperSQL DataBase |
informix | Informix |
ingres | Ingres |
instantdb | InstantDB |
interbase | InterBase |
mariadb | MariaDB |
maxdb | SAP MaxDB |
memcached | Memcached |
mongodb | MongoDB |
mssql | Microsoft SQL Server |
mssqlcompact | Microsoft SQL Server Compact |
mysql | MySQL |
neo4j | Neo4j |
netezza | Netezza |
opensearch | OpenSearch |
oracle | Oracle Database |
other_sql | Some other SQL database. Fallback only. See notes. |
pervasive | Pervasive PSQL |
pointbase | PointBase |
postgresql | PostgreSQL |
progress | Progress Database |
redis | Redis |
redshift | Amazon Redshift |
spanner | Cloud Spanner |
sqlite | SQLite |
sybase | Sybase |
teradata | Teradata |
vertica | Vertica |
Attribute | Type | Description | Examples |
---|---|---|---|
deployment.release_build_version | string | resource experimental The build version of the deployed product. | 2021-03-24 |
deployment.release_product | string | resource experimental The name of the deployed product. | WoGo Main |
deployment.release_stage | string | resource experimental The stage the product is deployed to. | production |
deployment.release_version | string | resource experimental The version of the deployed product. | 0.4.1 |
The device namespace contains information on the device running an application. This should only be used for end-user devices or devices outside of a private infrastructure. In line with the naming conventions and guidelines, we are in this case adhering to the emerging Open Telemetry convention around this, with some additions.
Attribute | Type | Description | Examples |
---|---|---|---|
device.battery.level | long | experimental The device's battery level in the range 0% (discharged) to 100% (fully charged). | 100 |
device.orientation | string | experimental The device orientation. | landscape |
device.orientation
MUST be one of the following:
Value | Description |
---|---|
landscape | The device was in landscape mode. |
portrait | The device was in portrait mode. |
Attribute | Type | Description | Examples |
---|---|---|---|
device.is_rooted | boolean | resource experimental If set to true , the device is rooted or jailbroken. | false |
device.manufacturer | string | resource experimental The device manufacturer. | Apple |
device.model.identifier | string | resource experimental The device model identifier. | iPhone3,4 |
device.screen.height | long | resource experimental The device's screen height in its natural orientation. | 1152 |
device.screen.width | long | resource experimental The device's screen width in its natural orientation. | 2048 |
Fields describing a disk.
Attribute | Type | Description | Examples |
---|---|---|---|
disk.all_mountpoints | string[] | resource experimental List of all mountpoints | [/mnt/storage, /home, /var/log] |
disk.device_name | string | resource experimental Disk device name (Linux, AIX) | sda |
disk.mountpoint | string | resource experimental Primary mountpoint | /mnt/storage |
disk.remote_disk_id | long | resource stable Unique identifier of remote disk | 0 ; 16864135562327138441 ; 18446744073709551615 |
Attribute | Type | Description | Examples |
---|---|---|---|
db.dli.pcb | string | experimental The name of the program communication block associated with this DL/I method. | 3 ; MYPCBNAM |
db.dli.pcb_type | string | experimental The PCB type. | DC ; DL/I ; F/P |
db.dli.processing_options | string | experimental The PCB processing options. | GR |
db.dli.segment_level | string | experimental The hierarchical level of the segment that was matched or returned. | 3 ; 24 |
db.dli.segment_name | string | experimental The name of the last segment that was matched or returned. | PARTROOT |
db.dli.status_code | string | experimental The DL/I status code. | QC |
db.dli.terminal_name | string | experimental The DL/I database or logical terminal name associated with this DL/I method. | HWSAM5ZD ; 10505 |
db.dli.pcb_type
MUST be one of the following:
Value | Description |
---|---|
DC | Data communications. |
DL/I | DL/I db. |
F/P | Fast Path. |
Attribute | Type | Description | Examples |
---|---|---|---|
dotnet.dll.file | string | resource experimental Filename of main dotnet assembly. | |
dotnet.dll.path | string | resource experimental Filepath of main dotnet assembly. |
Metadata with ActiveGate realated information.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.active_gate.group.name | string | resource experimental The name of a group that the ActiveGate instance belongs to. | GdanskLab |
dt.active_gate.id | string | resource experimental Hexadecimal identifier of the ActiveGate prefixed with 0x | 0xef3d21c3 |
dt.active_gate.module_name | string | resource experimental The name of ActiveGate module | autoupdate |
dt.active_gate.working_mode | string | resource experimental Working mode of the ActiveGate | cluster |
dt.active_gate.working_mode
MUST be one of the following:
Value | Description |
---|---|
cluster | Cluster ActiveGate |
embedded | Embedded ActiveGate |
environment | Environment ActiveGate |
multitenant | Multitenant ActiveGate |
Attribute | Type | Description | Examples |
---|---|---|---|
dt.active_gate.api_connector.config_id | string | resource experimental Config long id of the endpoint configuration as a string. | 123 ; 9276 |
dt.active_gate.api_connector.pipeline_identifier | string | resource experimental String identifier of an api connector pipeline | Kubernetes/Topology |
dt.active_gate.api_connector.pipeline_status | string | resource experimental Status of an api connector pipeline run | failed |
dt.active_gate.api_connector.technology_id | string | resource experimental String identifier of an api connector technology | Kubernetes ; CloudFoundry ; AWS ; Dynatrace Extension ; Azure |
dt.active_gate.api_connector.pipeline_status
MUST be one of the following:
Value | Description |
---|---|
failed | Pipeline execution failed |
skipped | Pipeline execution skipped |
succeeded | Pipeline execution succeeded |
Metadata of the OneAgent module that reported a signal. These attributes are what one would also see in OneAgent Health.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.agent.module.id | uid | resource stable OneAgent module ID. | 031f613871fab0b4 ; fc3cd1bb276f0bed |
dt.agent.module.parent_id | uid | resource stable OneAgent parent module ID, in case this is a so-called sub-agent | ea89eef5db8b85a9 |
dt.agent.module.type | string | resource stable OneAgent module type | apache |
dt.agent.module.version | string | resource stable OneAgent full module version | 1.269.17.20221117-132428 |
dt.agent.module.version_short | string | resource experimental OneAgent short module version, to be expected only on record types where dt.agent.module.version 's cardinality would be a problem | 1.269 |
dt.agent.monitoring_mode | string | resource experimental Monitoring Mode in which given agent operates | DISCOVERY |
dt.agent.module.type
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
apache | apache |
dotnet | dotnet |
dumpproc | dumpproc |
extensions | extensions |
go | go |
iis | iis |
java | java |
log_analytics | log_analytics |
net | net |
nettracer | nettracer |
nginx | nginx |
nodejs | nodejs |
opentracingnative | opentracingnative |
os | os |
php | php |
plugin | plugin |
process | process |
python | python |
remote_plugin | remote_plugin |
ruby | ruby |
sdk | sdk |
support | support |
updater | updater |
varnish | varnish |
wsmb | wsmb |
z | z_ |
dt.agent.monitoring_mode
MUST be one of the following:
Value | Description |
---|---|
DISCOVERY | Discovery monitoring mode provides basic metrics enabling you to discover your hosts and processes and learn the potential to extend your monitoring. |
FULL_STACK | Full stack monitoring mode includes application performance, user experience data, code-level visbility and PurePath insights, as well as everything that is included in Infrastructure monitoring mode. |
INFRASTRUCTURE | Infrastructure monitoring mode includes topology discovery, detailed health and performance monitoring of your host, and enables Network monitoring, Log monitoring and Extensions. |
Fields defined in this namespace are used by Dynatrace to describe various aspects of events emitted by the AutomationEngine.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.automation_engine.action.app | string | experimental The app id of the app containing the executed action. | dynatrace.workflows |
dt.automation_engine.action.function | string | experimental Name of the function implementing the action. | task_1 |
dt.automation_engine.action_execution.id | string | experimental The unique identifier of a action execution as UUID. | 23e7b55a-884f-4497-8ad6-8d49d52b4348 |
dt.automation_engine.action_execution.loop.index | long | experimental Loop index of the action execution. | |
dt.automation_engine.action_execution.retry.count | long | experimental Retry count of the action execution. | |
dt.automation_engine.is_draft | boolean | experimental Indicates whether the triggered workflow execution is based on a workflow draft. | true ; false |
dt.automation_engine.root_workflow.id | string | experimental The unique identifier of the root workflow. | e6388e3a-9db2-4226-9327-2ba86eaf12f7 |
dt.automation_engine.root_workflow_execution.id | string | experimental The unique identifier of the execution of the root workflow. | a641fb59-4627-44cd-abaf-b68d86455a5b |
dt.automation_engine.state | string | experimental The state of an execution. Values depend on type of execution (workflow-, task-, or action execution). | IDLE ; RUNNING ; WAITING ; SUCCESS ; ERROR ; CANCELLED |
dt.automation_engine.state.is_final | boolean | experimental Indicates 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 Additional info about current state of execution. Typically holds error details. | ERROR |
dt.automation_engine.task.name | string | experimental The identifier of a task within a workflow. | task_1 |
dt.automation_engine.task_execution.id | string | experimental The unique identifier of a task execution as UUID. | 6580d4af-6b1f-4e54-92fa-f47e94507acd |
dt.automation_engine.throttle.limit | long | experimental The workflow execution per hour limit that has been reached. | 1000 |
dt.automation_engine.workflow.id | string | experimental The unique identifier of a workflow as UUID. | 26c0334e-a3e1-4585-8cd8-2d72742fe141 |
dt.automation_engine.workflow.last_execution_state_flip | boolean | experimental Indicates if the workflow execution state has changed since the last execution, ignoring draft executions. Always false for draft executions. | true ; false |
dt.automation_engine.workflow.title | string | experimental The title of the workflow. | My Workflow |
dt.automation_engine.workflow.type | string | experimental Workflow type, either SIMPLE or STANDARD, where SIMPLE comes with restrictions. | SIMPLE ; STANDARD |
dt.automation_engine.workflow_execution.id | string | experimental The unique identifier of a workflow execution as UUID. | 737a248b-d1cb-49a4-bf08-7d4c37dbfb1e |
dt.automation_engine.workflow_execution.trigger.type | string | experimental The identifier that describes the trigger of the workflow. | Schedule ; Event ; Workflow ; Manual |
dt.automation_engine.workflow_execution.trigger.user.id | string | experimental The unique identifier of the user who triggered the workflow execution manually/via API. | dad18fa7-3c11-40a1-b760-1d8281bb5dcc |
dt.automation_engine.workflow_execution.trigger.workflow_execution.id | string | experimental The unique identifier of the workflow that triggered the workflow execution. | 737a248b-d1cb-49a4-bf08-7d4c37dbfb1e |
Attributes defined in this namespace are used by Dynatrace to describe different aspects of the ingested data.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.da.aws.data_firehose.arn | string | experimental ARN of AWS Data Firehose signal is originating from. | arn:aws:firehose:us-east-1:111110000111:deliverystream/tenantId-http-endpoint-direct-firehose-stream |
dt.da.aws.log_group | string | experimental Name of the source Amazon CloudWatch Log group | /aws/lambda/a-SomeFumction-1AWHD6W1QC5DH |
dt.da.aws.log_stream | string | experimental Name of the source Amazon CloudWatch Log stream | 2025/02/18/[$LATEST]12312312313123123123123123123123 |
dt.da.aws.s3.bucket.name | string | experimental Name of S3 bucket name signal is originating from | aws-cloudtrail-logs |
dt.da.aws.s3.key.name | string | experimental Name of S3 bucket name signal is originating from | AWSLogs/111110000111/CloudTrail/us-east-1/2025/02/18/111110000111_CloudTrail_us-east-1_20250218T0000Z.json.gz |
dt.da.azure.event_hub.location | string | experimental The location of the Event Hub that the signal is originating from | polandcentral |
dt.da.azure.event_hub.name | string | experimental The name of the Event Hub that the signal is originating from | logs-ingest-eventHub/logs-ingest |
dt.da.source | string | experimental Dynatrace source of signal ingestion | aws-log-ingest |
dt.da.source
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
aws-log-ingest | aws-log-ingest |
aws-metric-poller | aws-metric-poller |
aws-metrics-ingest | aws-metrics-ingest |
Some attributes are used in the context of the Davis engine.
These fields can be set in events to influence the Davis engine behavior.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.davis.analysis_time_budget | long | stable The time budget (in seconds) that the Davis® engine is granted before it must raise a problem. The analysis time budget can be set per event and controls the balance of sending out alerts early and granting the AI analysis enough time to finish its analysis. The trade-off of a short analysis budget is that the root cause and event merge analysis is limited or even skipped. For example, the time budget of 0 seconds means that the event raises a problem and sends the alert immediately, without any analysis. | |
dt.davis.analysis_trigger_delay | long | stable The time delay (in seconds) before the trigger of Davis® analysis. For example, the delay of 0 seconds triggers a Davis® problem and the root cause analysis immediately. The trigger delay can be used to hold the analysis until all the relevant root cause data has arrived to Dynatrace. For example, it might be beneficial for cloud integrations or log integrations that report data in different schedules - you can delay the analysis until data from all sources is available. Note that while longer delays means more data is available for root cause analysis, it also delays alerts delivery. | |
dt.davis.is_entity_remapping_allowed | boolean | stable This flag defines whether the remapping of the target entity is enabled (true) or disabled (false). If the remapping is enabled, Dynatrace can map the event to an entity extracted from the event metadata. If the remapping is disabled or the extraction is not possible, Dynatrace maps the event to the entity specified in the event configuration (for example, a specific host) or to the global environment entity. | |
dt.davis.is_frequent_issue_detection_allowed | boolean | stable The flag controls whether the Davis® engine should detect frequent issues. If the flag is set to true, events identified as frequent won't be triggered or merged into a problem. If the flag is set to false, frequent issues won't be detected and events will be triggered and merged as normal. | |
dt.davis.is_merging_allowed | boolean | stable This flag controls whether the Davis® engine is allowed to merge this event into a larger problem (true) or if a new problem must be created (false). | |
dt.davis.is_problem_suppressed | boolean | stable This flag controls whether the Davis® engine suppresses the problem from showing up in the UI and sending notifications. | |
dt.davis.is_rootcause_relevant | boolean | stable This flag controls whether the Davis® engine should include this event within the root cause analysis (true) or if it is not (false) relevant. | |
dt.davis.preferred_entity_type | string | stable The preferred entity type for remapping. You can find possible values in Dynatrace UI under Settings > Topology model > Generic types. If the remapping (dt.event.allow_entity_remapping) is enabled, this property defines the entity type to which the event should be mapped. If no entity of the preferred type is extracted, no remapping is applied. | my.custom.entity.type |
dt.davis.timeout | long | stable The event timeout period (in minutes). Various event sources use this event property to keep an event active by regularly refreshing an initial event. The timeout defines how fast the event source must refresh an event to keep it active. To keep the event active, the event source must send the refresh within the timeout period. If no refresh is sent, the event is automatically closed by Dynatrace after the timeout period. Note that metric sources use their own configurable de-alerting windows to close events. Setting the timeout shorter than the de-alerting window will force events to close and increase the risk of false-positive alerts. | |
dt.event.correlation_tag | string | experimental Set this tag to control which event reports connect together. This value is combined with internal system fields, such as event.name, dt.source_entity and event.provider, to generate a unique correlation id for event tracking. The final correlation id that is used for connecting event reports is stored in dt.event.correlation_id. | custom correlation tags |
These fields can be set by Davis routines.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.davis.anomaly_detection.alert | long | stable Boolean time series of 0 and 1 showing whether a single timespan was alerted due to continuous violations. | |
dt.davis.anomaly_detection.anomaly | long | stable Boolean timeseries of 0 and 1 showing whether a single timespan is outside the normal value range and therefore considered as abnormal. | |
dt.davis.anomaly_detection.lower | long | stable The lower value range limit where any value below this point is considered abnormal. | |
dt.davis.anomaly_detection.upper | long | stable The upper value range limit where any value above this point is considered abnormal. | |
dt.davis.forecast.lower | long | stable The lower bound of the prediction interval of a given metric forecast. | |
dt.davis.forecast.point | long | stable The point value of a metric forecast. | |
dt.davis.forecast.upper | long | stable The upper bound of the prediction interval of a given metric forecast. |
Fields that can be expected on a Dynatrace span where endpoint detection was applied.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.endpoint_detection.rule_id | uid | experimental The ID of the endpoint detection rule that was applied to that span. | 4d76194c11a9426197a9062548f9e66e |
The dt.enrichment namespace contains fields related to Dynatrace Apps and App-Functions that are used for security intelligence enrichment execution.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.enrichment.duration | duration | experimental The duration of the enrichment execution in nanoseconds. | 4000000000 |
dt.enrichment.integration.connection.id | string | experimental The identifier of the connection settings object used to execute the enrichment. The connection settings object ID refers to the connection in the settings section of the integration app. | vu9U3hXa3q0AAAABACNhcHA6ZHluYXRyYWNlLmFidXNlaXBkYjpjb25uZWN0aW9ucwAGdGVuYW50AAZ0ZW5hbnQAJDA0NzY2OTJhLTIzMDItMzdhOS05MTk5LTc1ZWI3M2MzNjYwMr7vVN4V2t6t |
dt.enrichment.integration.id | string | experimental The unique application identifier of the integration app that provided the enrichment functionality. Dynatrace apps are prefixed with 'dynatrace.', custom apps are prefixed with 'my.'. | dynatrace.abuseipdb ; dynatrace.virustotal |
dt.enrichment.integration.method.id | string | experimental The integration method ID of the integration app used to execute the enrichment. | check-ip ; enrich-observable |
dt.enrichment.result.is_cached | boolean | experimental Indicates whether the enrichment execution result was retrieved from the cache. | true ; false |
The Dynatrace OneAgent associates monitoring data with a so called Monitored Entity ID (ME ID). On OneAgent monitored environments, whenever ME IDs are accessible within the monitored system they should be used to enrich monitoring data to facilitate correlations with data primarily addressed through ME IDs coming from other channels.
The structure for keys that signify entity IDs is dt.entity.{type of entity}
.
The value associated with such a key must be valid Dynatrace entity identifier
(see Monitored entities API).
To allow linking Entity IDs across various different monitoring artifacts (logs, metrics, etc.), all string representations of Entity IDs are required to follow a canonical form, which for all current entities is defined as PREFIX-0123456789ABCDEF
.
Consumers should treat the token as an opaque value and must not infer any semantics on the ID itself. Producers need to match the Entity ID that is being returned by Dynatrace Entity API verbatim.
Producers of string representation must treat the string as if it was parsed case-sensitively, even though some parts of the product may be more lenient.
The structure of the entity ID is currently as follows: <ID-NAMESPACE>-<16-digit-hex-string>
. The <ID-NAMESPACE>
is type specific but cannot be used to determine the actual entity type reliably, especially in cases of CUSTOM_DEVICE
. The <16-digit-hex-string>
needs to be zero-padded (prefix) to a length of 16 digits and must use upper case letters A-F
.
Current entity IDs in cannonical form can be represented structurally with the following regular expression: [A-Z][A-Z_]*-[0-9A-F]{16}
.
Additional characters or changes in the format may happen in the future but will not invalidate existing IDs or ID generation rules.
When adding a name to an entity ID via the Grail function entityName, by default, the name of the respective entity will be represented as dt.entity.{type of entity}.name
. Similarly, further entity attributes can be added via the Grail function entityAttr, resulting in additional field(s) following the naming convention dt.entity.{type of entity}.{name of attribute}
.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.entity.application | string | resource stable The ME ID of a web application. Tags: entity-id | APPLICATION-DC92E74A7A844E6E |
dt.entity.aws_availability_zone | string | resource stable An entity ID of an entity of type AWS_AVAILABILITY_ZONE Tags: entity-id | AWS_AVAILABILITY_ZONE-6000A4E2BD2AB971 |
dt.entity.azure_region | string | resource stable An entity ID of an entity of type AZURE_REGION Tags: entity-id | AZURE_REGION-0DD5C79E4034F0AA |
dt.entity.azure_vm | string | resource stable An entity ID of an entity of type AZURE_VM Tags: entity-id | AZURE_VM-326478B733D6CFB0 |
dt.entity.cloud_application | string | resource stable An entity ID of an entity of type CLOUD_APPLICATION. Tags: entity-id | CLOUD_APPLICATION-3AB5BBF3E09A7942 |
dt.entity.cloud_application_instance | string | resource stable An entity ID of an entity of type CLOUD_APPLICATION_INSTANCE. Tags: entity-id | CLOUD_APPLICATION_INSTANCE-E0D8F94D9065F24F |
dt.entity.cloud_application_namespace | string | resource stable An entity ID of an entity of type CLOUD_APPLICATION_NAMESPACE. A CLOUD_APPLICATION_NAMESPACE is a Kubernetes namespace. Tags: entity-id | CLOUD_APPLICATION_NAMESPACE-C61324AA70F57BCB |
dt.entity.container_group | string | resource stable An entity ID of an entity of type CONTAINER_GROUP. Tags: entity-id | CONTAINER_GROUP-7C2B1C24FFB288CB |
dt.entity.container_group_instance | string | resource stable An entity ID of an entity of type CONTAINER_GROUP_INSTANCE. Tags: entity-id | CONTAINER_GROUP_INSTANCE-F4A1347110826781 |
dt.entity.custom_application | string | resource stable The ME ID of a custom application. Tags: entity-id | CUSTOM_APPLICATION-343A92501A51F286 |
dt.entity.custom_device | string | resource stable An entity ID of an entity of type CUSTOM_DEVICE. Tags: entity-id | CUSTOM_DEVICE-E0D8F94D9065F24F |
dt.entity.disk | string | resource stable An entity ID of an entity of type DISK Tags: entity-id | DISK-5472CBC1ED0981D6 |
dt.entity.ec2_instance | string | resource stable An entity ID of an entity of type EC2_INSTANCE Tags: entity-id | EC2_INSTANCE-0004DD30F142D18C |
dt.entity.external_synthetic_test | string | resource stable An entity ID of an entity of type EXTERNAL_SYNTHETIC_TEST. Tags: entity-id | EXTERNAL_SYNTHETIC_TEST-A140F3B85BCCBD1A |
dt.entity.external_synthetic_test_step | string | resource stable An entity ID of an entity of type EXTERNAL_SYNTHETIC_TEST_STEP. Tags: entity-id | EXTERNAL_SYNTHETIC_TEST_STEP-A140F3B85BCCBD1A |
dt.entity.gcp_zone | string | resource stable An entity ID of an entity of type GCP_ZONE Tags: entity-id | GCP_ZONE-3699CB75E19C8505 |
dt.entity.host | string | resource stable An entity ID of an entity of type HOST. Tags: entity-id | HOST-E0D8F94D9065F24F |
dt.entity.host_group | string | resource stable An entity ID of an entity of type HOST_GROUP. Tags: entity-id | HOST_GROUP-E7FBBCF7B1467174 |
dt.entity.http_check | string | resource stable An entity ID of an entity of type HTTP_CHECK. Tags: entity-id | HTTP_CHECK-A140F3B85BCCBD1A |
dt.entity.http_check_step | string | resource stable An entity ID of an entity of type HTTP_CHECK_STEP. Tags: entity-id | HTTP_CHECK_STEP-A140F3B85BCCBD1A |
dt.entity.kubernetes_cluster | string | resource stable An entity ID of an entity of type KUBERNETES_CLUSTER. Tags: entity-id | KUBERNETES_CLUSTER-E0D8F94D9065F24F |
dt.entity.kubernetes_node | string | resource stable An entity ID of an entity of type KUBERNETES_NODE. Tags: entity-id | KUBERNETES_NODE-874C66B68CE15070 |
dt.entity.kubernetes_service | string | resource stable An entity ID of an entity of type KUBERNETES_SERVICE. Tags: entity-id | KUBERNETES_SERVICE-FE6E75BB9DF02347 |
dt.entity.mobile_application | string | resource stable The ME ID of a mobile application. Tags: entity-id | MOBILE_APPLICATION-E8A8751A60D5BCE8 |
dt.entity.multiprotocol_monitor | string | resource stable An entity ID of an entity of type MULTIPROTOCOL_MONITOR. Tags: entity-id | MULTIPROTOCOL_MONITOR-A140F3B85BCCBD1A |
dt.entity.network_interface | string | resource stable An entity ID of an entity of type NETWORK_INTERFACE Tags: entity-id | NETWORK_INTERFACE-FC7B4A5937FC125C |
dt.entity.process_group | string | resource stable An entity ID of an entity of type PROCESS_GROUP. Tags: entity-id | PROCESS_GROUP-E0D8F94D9065F24F |
dt.entity.process_group_instance | string | resource stable An entity ID of an entity of type PROCESS_GROUP_INSTANCE. Tags: entity-id | PROCESS_GROUP_INSTANCE-E0D8F94D9065F24F |
dt.entity.service | string | resource stable An entity ID of an entity of type SERVICE. Tags: entity-id | SERVICE-57EC3CFC1FE72449 |
dt.entity.service_method | string | resource stable An entity ID of an entity of type SERVICE_METHOD. Tags: entity-id | SERVICE_METHOD-659B35CA9AAC96C1 |
dt.entity.service_method_group | string | resource stable An entity ID of an entity of type SERVICE_METHOD_GROUP. Tags: entity-id | SERVICE_METHOD_GROUP-02000E1DB1CDAF9F |
dt.entity.synthetic_location | string | resource stable An entity ID of an entity of type SYNTHETIC_LOCATION. Tags: entity-id | SYNTHETIC_LOCATION-D140F3B85BCCBD1A |
dt.entity.synthetic_test | string | resource stable An entity ID of an entity of type SYNTHETIC_TEST. Tags: entity-id | SYNTHETIC_TEST-A140F3B85BCCBD1A |
dt.entity.synthetic_test_step | string | resource stable An entity ID of an entity of type SYNTHETIC_TEST_STEP. Tags: entity-id | SYNTHETIC_TEST_STEP-A140F3B85BCCBD1A |
Additional extension information sent via self-monitoring.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.extension.config.id | string | resource experimental Extension's monitoring configuration identifier. | vu9U3hXa3q0AAAABAAtleHQ6ZXh0LTA0MAAIYWdfZ3JvdXAAA0FHMQAkMjY2YTIyM2YtZDgxYi0zNTNjLThlYzctYzk2YzliZjg4OGQ3vu9U3hXa3q0 |
dt.extension.ds | string | resource experimental Name of the data source. | SNMPTrap |
dt.extension.endpoint.hints | string[] | resource experimental Hints to provide for the cluster in order to find proper endpoint in task registry. | [nat-test.lab.dynatrace.org, 1521, orc] |
dt.extension.name | string | resource experimental Name of the extension. | com.snmptrap.generic |
dt.extension.status | string | resource experimental The status of the component reporting a self-monitoring event. | AUTHENTICATION_ERROR |
dt.extension.status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
AUTHENTICATION_ERROR | Unable to connect to EEC |
DEVICE_CONNECTION_ERROR | Failed to establish connection with the device |
EEC_CONNECTION_ERROR | Unable to connect to EEC |
GENERIC_ERROR | Generic status used to communicate job failed |
INVALID_ARGS_ERROR | Invalid arguments |
INVALID_CONFIG_ERROR | Config provided by EEC is invalid |
OK | Extension works fine |
UNKNOWN_ERROR | Uninitialized/unknown error |
Attributes used for Process Group enrichment in extensions.
Attributes defined in this namespace are used by Dynatrace to describe different aspects of the ingested data.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.ingest.debug_messages | string[] | experimental An array of strings that represent debug messages that provide a detailed debugging information. That could include even variable parts, like which attribute was modified, or which processing rules were applied. | [MyATTribute mapped to myAttribute] |
dt.ingest.format | string | experimental The format of the data ingested in Dynatrace via the various ingest channels. E.g., Generic log ingest, OTLP logs ingest | dtapi/json ; otlp/protobuf |
dt.ingest.size | long | stable The size of the ingested data point in bytes. | 2005 |
dt.ingest.warnings | string[] | experimental An array of strings representing markers of unexpected situations that might affect the correctness or completeness of incoming data points. It might be, for instance, limits applied or a processing rule failing. It should not be a detailed log of what happened, just the high-level class of the issue that occurred. | [attr_count_trimmed, content_trimmed] |
dt.ingest.format
MUST be one of the following:
Value | Description |
---|---|
dtapi/json | JSON data ingested via the Dynatrace APIs or via EEC (Extension Execution Controller) |
dtapi/plaintext | (deprecated: use "plaintext") Plain text data ingested via the Dynatrace API |
journald | Journald data ingested via OneAgent |
otlp/json | OpenTelemetry Protocol (OTLP) JSON data ingested via the Dynatrace APIs |
otlp/protobuf | OpenTelemetry Protocol (OTLP) Protobuf data ingested via the Dynatrace APIs or via EEC (Extension Execution Controller) |
plaintext | Plain text data ingested via the Dynatrace APIs, EEC (Extension Execution Controller) or OneAgent |
syslog | Syslog data ingested via OneAgent |
unknown | The data format was not recognized (only for metrics dimension) |
windowseventlog | Windows event log data ingested via OneAgent |
dt.ingest.warnings
MUST contain only values from the following list:
Value | Description |
---|---|
content_trimmed | The content was trimmed, right after receiving it by Cluster/ActiveGate, because it exceeded the event content max byte size limit. |
content_trimmed_pipe | The content was trimmed in post-processing (after applying processing rules) because it exceeded the event content max byte size limit |
attr_count_trimmed | The number of attributes was trimmed, right after receiving it by Cluster/ActiveGate, because it exceeded the max number of attributes limit. |
attr_count_trimmed_pipe | The number of attributes was trimmed in post-processing (after applying processing rules) because it exceeded the max number of attributes limit. |
attr_key_case_mismatch | The attribute key is detected that matches the custom attribute key or the semantic attribute key, but there is the attribute key case mismatch. |
attr_key_trimmed | The attribute key was trimmed, right after receiving it by Cluster/ActiveGate, because it exceeded the max key length limit. |
attr_val_count_trimmed | At least one multi-value attribute had values number trimmed, right after receiving it by Cluster/ActiveGate, because it exceeded the max number of attributes limit. |
attr_val_count_trimmed_pipe | After applying processing rules, at least one multi-value attribute had its values number trimmed (after using processing rules) because it exceeded the maximum number of attributes limit. |
attr_val_size_trimmed | At least one attribute had its value size trimmed, right after receiving it by Cluster/ActiveGate, because it exceeded the max value size in bytes limit. |
attr_val_size_trimmed_pipe | At least one attribute had its value size trimmed (after applying processing rules) because it exceeded the max value size in bytes limit. |
timestamp_corrected | Timestamp was too far in the future and was corrected to current time. |
common_attr_corrected | STATUS, LOG_LEVEL or EVENT_TYPE attribute was corrected. |
processing_batch_timeout | Batch timeout occurred during processing pipeline. |
processing_transformer_timeout | Execution timeout in one of processing transformers occurred during processing pipeline. |
processing_transformer_error | Execution error in one of processing transformers occurred during processing pipeline. |
processing_transformer_throttled | Execution throttled in one of processing transformers during processing pipeline. |
processing_output_record_conversion_error | Output conversion error occurred for some record during processing pipeline. |
processing_prepare_input_error | Prepare input error occurred in one of enabled processing pipeline rules. |
Attribute | Type | Description | Examples |
---|---|---|---|
dt.cost.costcenter | string | resource stable Can be used to assign usage to a Cost Center. | Team A |
dt.cost.product | string | resource stable Can be used to assign usage to a Product or Application ID. | Product A |
dt.host_group.id | string | resource stable see Organize your environment using host groups. Note that host groups are identified by their name. This is not the entity ID of Host Group Entity, for which see dt.entity.host_group Tags: permission primary-field | myHostGroup |
dt.metrics.source | string | resource experimental The source from which metrics are ingested. 1 | telegraf ; com.dynatrace.extension.sql-oracle |
dt.network_zone.id | string | resource experimental The ID of the network zone. See Dynatrace Documentation | vpc-123 |
dt.pg_detection.cluster.id | string | resource experimentalDT_CLUSTER_ID environment variable; also see Process group detection | |
dt.pg_detection.custom_entry | string | resource experimental also see Define metadata via environment variables | |
dt.pg_detection.declarative.id | string | resource experimental | |
dt.pg_detection.environment.id | string | resource experimentalDT_ENVIRONMENT_ID environment variable | |
dt.pg_detection.node.id | string | resource experimentalDT_NODE_ID environment variable; also see Process group detection | |
dt.process_group.detected_name | string | resource stable The name of the process group as it was detect by the agent. | Apache Web Server httpd ; Redis unguard-redis-* redis |
dt.security_context | string | resource stable The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | |
dt.smartscape_source.id | string | resource experimental The ID of the entity considered the source of the signal. The string represents an entity ID of an entity that is stored in the Smartscape storage. 2 Tags: smartscape-id | K8S_CLUSTER-E0D8F94D9065F24F ; AWS_LAMBDA_FUNCTION-E0D8F94D9065F24F |
dt.smartscape_source.type | string | resource stable The entity type of the entity whose identifier is held in dt.smartscape_source.id. | K8S_CLUSTER ; AWS_LAMBDA_FUNCTION |
dt.source_entity | string | resource stable The ID of the entity considered the source of the signal. The string represents an entity ID of an entity that is stored in the classic entity storage. 3 Tags: entity-id | HOST-E0D8F94D9065F24F ; PROCESS_GROUP_INSTANCE-E0D8F94D9065F24F |
dt.source_entity.type | string | resource stable The entity type of the entity whose identifier is held in dt.source_entity. The value must be a valid entity type and consistent with dt.source_entity . Note, however, that the type identifiers are expected to be lowercased in alignment with suffixes of dt.entity.* keys. | host ; process_group_instance ; cloud:azure:resource_group |
This is the framework used for capturing, processing and forwarding metrics, not the emitting monitored entity. Exemplary custom value: name of an extension sending metrics.
The value of this field will be based on one of dt.smartscape.<type>
fields value. That means that both fields dt.smartscape_source.id
and dt.smartscape.<type>
will be set to the same ID.
The value of this field will be based on one of the dt.entity.<type>
fields value. This means that both dt.source_entity
and dt.entity.<type>
fields will be set to the same ID.
dt.metrics.source
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
dynatrace_codemodule | dynatrace_codemodule |
dynatrace_ingest | dynatrace_ingest |
dynatrace_osagent | OsAgent |
micrometer | Micrometer |
oneagent_metric_api | OneAgentMetricAPI |
opentelemetry | OpenTelemetry |
statsd | StatsD |
telegraf | Telegraf |
Attribute | Type | Description | Examples |
---|---|---|---|
dt.maintenance_window_ids | array | experimental UUIDs of maintenance windows. | c715d677-eb1b-3e1b-8dbc-db06cad5b8eb |
dt.query | string | experimental A query in the DQL format, see Dynatrace Query Langauge. | timeseries avg(dt.host.cpu.idle) ; fetch logs |
dt.raw_data | string | experimental The complete content of the record as it was originally accepted by Dynatrace, stored as a string in JSON format. This field captures the unaltered data for reference, debugging, or auditing purposes | {"content": "example record content"} |
Fields defined in this namespace are used by Dynatrace to describe various aspects of the data ingested through OpenPipeline, providing detailed insights into the ingestion process.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.openpipeline.pipelines | string[] | resource experimental Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey. | [[logs:default], [logs:pipeline_haproxy_2656, bizevents:default]] |
dt.openpipeline.source | string | resource experimental Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events ; oneagent |
dt.openpipeline.source_type | string | resource experimental Identifies the source type used to ingest data in Dynatrace, for example, from OTLP and OneAgent. | otlp ; oneagent |
dt.openpipeline.source_type
MUST be one of the following:
Value | Description |
---|---|
api | Logs ingested via one of the ActiveGate APIs |
aws_firehose | Logs ingested via Amazon Data Firehose |
extension | Logs ingested via the EEC running on host |
oneagent | Logs ingested via OneAgent |
otlp | Logs ingested via the OpenTelemetry Protocol (OTLP) |
unknown | The source type was not recognized (only for metrics dimension) |
The dt.rum namespace contains Dynatrace RUM specific fields.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.rum.application.entity | string | experimental An entity ID of an entity of type APPLICATION or MOBILE_APPLICATION. Tags: entity-id | APPLICATION-DC92E74A7A844E6E ; MOBILE_APPLICATION-E8A8751A60D5BCE8 |
dt.rum.application.id | string | stable The Dynatrace RUM application ID. For mobile applications, a UUID is used. For web applications, an 8-byte HEX string is used. | ea7c4b59f27d43eb ; 89b1a1e7-fe89-4151-81e9-410fa0235f0d |
dt.rum.browser.session_id | string | experimental The browser session ID, taken from the dtCookie value. Not applicable for OneAgent for Mobile. | 4D3133F359A76AB05AAF39691696858A |
dt.rum.session.id | string | stable A unique ID that represents the user session. | HOPCPWKILUKHFHWRRQGBHHPAFLUJUOSH-0 ; 23626166142035610_1-0 |
dt.rum.user_tag | string | experimental The user tag. | john.doe@dynatrace.com |
Attribute | Type | Description | Examples |
---|---|---|---|
dt.rum.agent.type | string | resource experimental The Dynatrace RUM agent type. | android |
dt.rum.agent.version | string | resource experimental The version of the Dynatrace RUM agent. It is provided in the format major.minor.patch.build. The build number is optional. | 8.263.1 ; 9.293.2.1 ; 1.313.0.20250402-172634 |
dt.rum.event.source.type | string | resource experimental The Dynatrace RUM source technology that produced this event. Only used by cross-platform implementations, otherwise the field is omitted. | flutter |
dt.rum.instance.id | string | resource stable The RUM application instance ID. (This was formerly called the "Visitor id", "internal user ID", and "rxVisitor cookie value".) | 3735928559 ; 1742973444821E7E6Q3E3SG28ATQPAGTT6T8HU92VFRFQ |
dt.rum.schema_version | string | resource stable The Dynatrace RUM enrichment version. | 0.1 |
dt.rum.user_type | string | resource experimental The RUM user type. | real_user |
dt.rum.agent.type
MUST be one of the following:
Value | Description |
---|---|
android | OneAgent for Android |
ios | OneAgent for iOS |
javascript | RUM JavaScript |
dt.rum.event.source.type
MUST be one of the following:
Value | Description |
---|---|
flutter | Flutter |
react_native | React Native auto-instrumentation |
dt.rum.user_type
MUST be one of the following:
Value | Description |
---|---|
real_user | The user event was produced by a real user. |
robot | The user event was produced by a bot user. |
synthetic | The user event was produced by a synthetic test. |
The dt.rum.invalid
namespace is used for fields that are removed because of user event ingest validation.
For example, if the calculated web_vitals.largest_contentful_paint
value would be less than 0, the value is copied over to dt.rum.invalid.web_vitals.largest_contentful_paint
and web_vitals.largest_contentful_paint
is removed.
Fields for referencing Settings 2.0 objects, schemas and scopes.
Although the dt.settings.object_id
is enough to identify a specific settings value within a dynatrace environment, adding explicit information about the schema, scope and/or scope type can be useful nonetheless. If your use-case will only ever involve a single schema, scope type and/or scope, documenting this is good enough - if multiple schemas, scope types and/or scopes can be involved, filling the corresponding fields is strongly recommended.
dt.settings.references
can be used if multiple settings objects need to be referenced. In that case, each entry in the array can hold a reference to a single settings object.
The top level fields contain generally relevant information for all monitoring data.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.settings.object_id | string | experimental The object ID of a settings value. This corresponds to the 'objectId' field/parameter in the Settings API. | vu9U3hXa3q0AAAABACFidWlsdGluOnJ1bS51c2VyLWV4cGVyaWVuY2Utc2NvcmUABnRlbmFudAAGdGVuYW50ACRhMzZmYmYwMy00NDY1LTNlNTYtOTZiOS1kOWMzOGQ3MzU1NmO-71TeFdrerQ |
dt.settings.object_summary | string | experimental The human-readable summary or name of a single value of a multi-value settings schema. This corresponds to the 'summary' field in the Settings API. | Journey Service all errors ; Really, this can be anything ; My alerting rule |
dt.settings.references | record[] | experimental A collection of references to settings objects. Each entry in the array holds a reference to a single settings object. | [{'dt.settings.object_id': 'vu9U3hXa3q0AAAABACFidWlsdGluOnJ1bS51c2VyLWV4cGVyaWVuY2Utc2NvcmUABnRlbmFudAAGdGVuYW50ACRhMzZmYmYwMy00NDY1LTNlNTYtOTZiOS1kOWMzOGQ3MzU1NmO-71TeFdrerQ', 'dt.settings.relationship': 'matched_rule'}, {'dt.settings.object_id': 'vu9U3hXa3q0AAAABAB9idWlsdGluOmRhdmlzLmFub21hbHktZGV0ZWN0b3JzAAZ0ZW5hbnQABnRlbmFudAAkMzM2NTc3MTgtYWNjYi0zOGY1LTlmOGUtMTg5NTBiYmNjNmRhvu9U3hXa3q0', 'dt.settings.relationship': 'triggered_alert'}] |
dt.settings.relationship | string | experimental The type of relationship to the referenced settings object. You can use arbitrary values (in snake_case ) here that describe the relationship for your use-case. | matched_rule ; triggered_alert |
dt.settings.schema_id | string | experimental The schema ID of a settings schema, as used in the Settings APIs. | builtin:problem.notifications ; app:dynatrace.jenkins:connection |
dt.settings.schema_version | string | experimental The version of the schema referenced by dt.settings.schema_id, as declared by the schema itself. Typically a semantic version number. | 1.0.0 ; 1.2.3 |
dt.settings.scope_id | string | experimental The ID of the scope that a settings object is persisted on. This corresponds to the 'scope' field/parameter in the Settings API. | environment ; HOST-EFAB6D2FE7274823 |
dt.settings.scope_name | string | experimental The human-readable name of the scope that a settings object is persisted on. | deb-10-k3s-oi-01.lab.dynatrace.org |
dt.settings.scope_type | string | experimental The type of the scope that a settings object is persisted on. | environment ; host_group ; host |
Entities stored in the Grail based Smartscape storage will coexist with classic entities. To ensure we can distinguish between classic IDs and Smartscape IDs, we use the dt.smartscape.*
namespace to enrich entity IDs in signal data.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.smartscape.__type__ | string | resource stable A Smartscape ID that can be used to query entities from the Smartscape storage. __type__ is a placeholder for any Smartscape type.Tags: smartscape-id | K8S_CLUSTER-E0D8F94D9065F24F |
Additional information about the attributes of a data point.
The dt.synthetic namespace contains Dynatrace synthetic specific fields.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.synthetic.batch.id | long | experimental The identifier of the batch (defined for on-demand executions only). | |
dt.synthetic.location.missing_capabilities | array | experimental Names of missing Synthetic location capabilities. | BROWSER ; ICMP |
dt.synthetic.monitor.id | string | experimental The identifier of the monitor. | HTTP_CHECK-6349B98E1CD87352 |
dt.synthetic.monitored_entity_ids | array | experimental IDs of monitored entities. | APPLICATION-EA7C4B59F27D43EB |
dt.synthetic.request.targets | array | experimental Request target addresses with DNS record type or TCP port number. | 127.0.0.1:22 |
dt.synthetic.violated_entity_ids | array | experimental IDs of synthetic monitor or steps. | HTTP_CHECK-9349B98E1CD87352 ; HTTP_CHECK_STEP-6349B98E1CD87352 |
The namespace dt.system
is reserved for Grail. These fields cannot be ingested but instead will be set by Grail directly. Every record that is fetched from Grail provides these fields, but by default they are hidden. You can display them by using the fieldsAdd
command.
Example query:
// display the bucket for each log recordfetch logs| fieldsAdd dt.system.bucket
Attribute | Type | Description | Examples |
---|---|---|---|
dt.system.bucket | string | stable The Grail bucket that the record is stored in. | default_logs ; default_spans ; default_bizevents |
dt.system.environment | string | stable The Dynatrace environment that the record belongs to. | wkf10640 |
dt.system.monitoring_source | string | stable Identifies the license under which the source is running. | fullstack_host ; infrastructure |
dt.system.sampling_ratio | long | stable The selected sampling ratio. | 1 |
dt.system.segment_id | string | stable The segment that the record belongs to. | 5d97c09e-7337-443e-bab5-2f0474804687 |
dt.system.storage_interval | string | stable Identifies the timeframe represented by individual data structures stored under a metric key. | 1 min |
dt.system.table | string | stable The table that the record belongs to. | logs ; bizevents |
dt.system.monitoring_source
MUST be one of the following:
Value | Description |
---|---|
discovery | The source is running under the discovery license. |
fullstack_container | The source is running under the full-stack container license. |
fullstack_host | The source is running under the full-stack host license. |
infrastructure | The source is running under the infrastructure license. |
mainframe | The source is running under the mainframe license. |
dt.system.storage_interval
MUST be one of the following:
Value | Description |
---|---|
1 min | The timeframe represented by individual measurements of a metrics record in storage. |
Fields defined in this namespace are used by Dynatrace to describe different aspects of the context propagation between spans.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.tracing.custom_link.id | uid | experimental The custom link ID to identify spans calling each other. The ID is derived from the custom link bytes. | 736bd2684696c4a8 |
dt.tracing.custom_link.original_bytes | binary | experimental The original binary data of the custom link. | ycXlxUBAQEDee9lm8pBcA8nF5cVAQEBA3nvZZvKQXAPee9lm8s4SAQ== |
dt.tracing.custom_link.transformed_bytes | binary | experimental The transformed binary data of the custom link. Only available if a mapping was applied. | ycXlxUBAQEDee9lm8pBcA8nF5cVAQEBA3nvZZvKQXAPee9lm8s4SAQ== |
dt.tracing.custom_link.type | string | experimental The type of the custom link defines if a mapping of the dt.tracing.custom_link.original_bytes to the dt.tracing.custom_link.transformed_bytes was applied. | generic |
dt.tracing.foreign_link.bytes | binary | experimental An incoming foreign link (cross-environment or cross-product). | 00000004000000010000000200000003000000040000002300000001 |
dt.tracing.foreign_link.text | string | experimental An incoming foreign link (cross-environment or cross-product). | FW4;129;12;-2023406815;4539717;0;17;66;c511;2h02;3h12345678;4h676767 ; FW1;129;4711;59959450;-1859959450;3;17;0 |
dt.tracing.link.direction | string | experimental The direction of the span link to define the correct order between spans. | outgoing |
dt.tracing.link.id | uid | experimental Unique identifier for a Dynatrace link. | |
dt.tracing.link.is_sync | boolean | experimentaltrue indicates that the caller waits on the response. Only available on span links with dt.tracing.link.direction set to outgoing . | |
dt.tracing.response.headers | record | experimental A collection of key-value pairs containing received response headers related to tracing from an outgoing call. There may be multiple values for each header. Used for cross-environment linking. | {'traceresponse': ['00-7b9e3e4068167838398f50017bfad358-d4ffc7e33530967a-01'], 'x-dt-tracestate': ['9651e1a8-19506b7c@dt']} |
dt.tracing.custom_link.type
MUST be one of the following:
Value | Description |
---|---|
generic | The dt.tracing.custom_link.original_bytes have no special meaning. |
ibm_mq | The dt.tracing.custom_link.original_bytes are an IBM MQ custom link. |
ibm_mq_ignore_qname | The dt.tracing.custom_link.original_bytes are an IBM MQ custom link, but the qname part should be ignored in mapping. |
dt.tracing.link.direction
MUST be one of the following:
Value | Description |
---|---|
incoming | Indicates that the link represents an incoming call (the child in a parent-child relationship). |
outgoing | Indicates that the link represents an outgoing call (the parent in a parent-child relationship). |
Attribute | Type | Description | Examples |
---|---|---|---|
elasticsearch.cluster.name | string | resource experimental | |
elasticsearch.node.name | string | resource experimental |
Endpoints define the public interface of services.
Attribute | Type | Description | Examples |
---|---|---|---|
endpoint.name | string | stable The endpoint name is derived from endpoint detection rules and uniquely identifies one endpoint of a particular service. Endpoint names are usually technology-specific and should be defined by attributes with low cardinality, like http.route or rpc.method . Endpoints are exclusively detected on request root spans. | GET / ; PUT /users/:userID? ; GET /productpage ; Reviews.GetReviews |
Attribute | Type | Description | Examples |
---|---|---|---|
equinox.config.path | string | resource experimental |
The error namespace contains general information on errors.
Attribute | Type | Description | Examples |
---|---|---|---|
error.code | long | experimental The code of the error. Set for iOS (NSError and Swift Error) and custom errors for C-based languages. | -1 ; 3072 |
error.csp_violation_count | long | experimental The number of CSP rule violations. | 1 |
error.display_name | string | experimental A human-readable version of error.id . | 500: foo.bar/path/file ; path/file:1:5 |
error.dropped_exception_count | long | experimental The number of exceptions that are observed, but which are not captured due to error capture limits. | 1 |
error.exception_count | long | experimental The total number of exceptions that are observed, including exceptions that are not captured. | 1 |
error.http_4xx_count | long | experimental The number of HTTP request errors with a http.response.status_code of 400 - 499. | 1 |
error.http_5xx_count | long | experimental The number of HTTP request errors with a http.response.status_code of 500 - 599. | 1 |
error.http_other_count | long | experimental The number of HTTP request errors with a http.response.status_code of 0-99 or 600+ (undefined errors). | 1 |
error.id | uid | experimental A unique identifier for error grouping. The error.id is a 16-byte ID and hex-encoded if shown as a string. | 357bf70f3c617cb34584b31bd4616af8 |
error.is_fatal | boolean | experimental If set to true , the error resulted in a fatal exit (for example, an unhandled exception). Otherwise this attribute should be omitted. | true |
error.reason | string | experimental The error reason. RUM JavaScript reports a pre-defined set of values. | no network |
error.source | string | experimental The error source. | fetch ; console |
error.type | string | experimental The main error type. This information is determined by Dynatrace RUM error grouping. | request |
error.reason
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
abort | The request was aborted by the user. |
csp | The request failed due to a Content Security Policy (CSP) violation. |
no_network | The request failed because of no connectivity. |
timeout | The request timed out. |
error.source
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
console | console |
document_request | document_request |
exception | exception |
fetch | fetch |
promise_rejection | promise_rejection |
xhr | xhr |
error.type
MUST be one of the following:
Value | Description |
---|---|
anr | Application Not Responding (ANR) |
crash | Crash |
csp | Content Security Policy (CSP) violation |
exception | Exception |
reported | Custom reported error |
request | Failed request |
Attribute | Type | Description | Examples |
---|---|---|---|
esb.application.name | string | resource experimental The name of the application that holds the workflows of the business logic. | myBusinessApp ; YourServiceApp ; any_work |
esb.library.name | string | resource experimental The name of the library that hosts commonly used workflows to be reused in applications. | myWebServicesLib ; YourMessagingLibrary ; any_tools |
esb.vendor | string | resource experimental The name of the vendor of the ESB technology of the current workflow. | ibm ; tibco |
esb.workflow.name | string | resource experimental The name of the workflow (the message flow for the IBM ESB). | myMessageFlow ; YourBusinessWorkflow ; any_flow |
The event namespace contains common identification, categorization and context on events in Dynatrace.
Attribute | Type | Description | Examples |
---|---|---|---|
event.category | string | stable Standard categorization based on the significance of an event (similar to the severity level in the previous Dynatrace). | Availability |
event.description | string | stable Human-readable description of an event. | The current response time (11 s) exceeds the auto-detected baseline (767 ms) by 1,336 % |
event.end | string | stable The event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). | 16481073970000 |
event.group_label | string | experimental Group label of an event. | Availability |
event.id | string | stable Unique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Gives high-level information about what kind of information the event contains without being specific about the contents of the event. It helps to determine the record type of a raw event. Tags: permission | INFRASTRUCTURE_EVENT ; DAVIS_EVENT ; BIZ_EVENT ; RUM_EVENT ; AUDIT_EVENT ; BILLING_USAGE_EVENT |
event.name | string | stable The human readable display name of an event type. | Process crashed ; CPU Saturation |
event.original_content | string | experimental The original raw data of the event as received from the source. | {"severity_id": 3,"state_id": 1,"time": "2024-06-26T07:15:06.139000Z","state": "New","type_uid": 200101} |
event.outcome | string | stable Denotes whether the event represents a success or a failure from the perspective of the entity that produced the event (for example an HTTP response code). | 200 ; success ; failure |
event.parent_id | string | experimental Unique identifier string of a parent event to link parent and child events. | 5547782627070661074_1647601319999 |
event.provider | string | stable Source of the event, for example, the name of the component or system that generated the event. Tags: permission | OneAgent ; K8S ; Davis ; VMWare ; GCP ; AWS ; LIMA_USAGE_STREAM |
event.reason | string | stable Describes why a certain event.outcome was set. Typically, this is some form of error description in the case of a failure. | user is missing permission "logs.read" |
event.start | string | stable The event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). | 16481073970000 |
event.status | string | stable Status of an event as being either Active or Closed. | Active |
event.status_transition | string | experimental An enum that shows the transition of the above event state. | Recovered |
event.type | string | stable The unique type identifier of a given event. Tags: permission | ESXI_HOST_MEMORY_SATURATION ; PROCESS_RESTART ; CPU_SATURATION ; MEMORY_SATURATION ; Automation Workflow ; AppEngine Functions - Small |
event.version | string | stable Describes the version of the event. | 1.0.0 |
Values are either in title-case or screaming snake case.
event.category
SHOULD be one of the following:
Value | Description |
---|---|
Availability | availability |
Error | error |
Slowdown | slowdown |
Resource contention | resource_contention |
Warning | warning |
Info | info |
Vulnerability management | vulnerability_management |
event.status
SHOULD be one of the following:
Value | Description |
---|---|
Active | active |
Closed | closed |
event.status_transition
SHOULD be one of the following:
Value | Description |
---|---|
Created | created |
Updated | updated |
Refreshed | refreshed |
Resolved | resolved |
Recovered | recovered |
Closed | closed |
Timed out | timed out |
Reopened | reopened |
Event properties are custom-defined key-value pairs. Dynatrace RUM captures event properties as part of each of your users' journeys to enrich user events.
Attribute | Type | Description | Examples |
---|---|---|---|
event_properties.__property_name__ | record | experimental Contains the value for the event property named __property_name__ defined by the event and session property configuration. The data type of the value depends on the definition; default is data type string . | 42 ; value |
Attribute | Type | Description | Examples |
---|---|---|---|
exception.caused_by_id | uid | stable The exception.id of the exception the current exception was caused by. | |
exception.column_number | long | experimental The column number where the exception happened. | 12304 |
exception.escaped | boolean | stabletrue indicates that the exception was recorded at a point where it is known that the exception escaped the scope of the span. | |
exception.file.domain | string | experimental The URI domain component. This is extracted from exception.file.full . | www.foo.bar |
exception.file.full | string | experimental The full file location when the exception happened. This is either an absolute URL or a filename. | https://www.foo.bar/path/main.js ; main.js |
exception.file.path | string | experimental The URI path component. This is extracted from exception.file.full . | /path/main.js |
exception.id | uid | stable The identifier of an exception. It should be unique within a list of exceptions of a span. The identifier is used to reference the exception. | |
exception.is_caused_by_root | boolean | stable Is set to true if the exception is the first exception caused by the chain. | |
exception.line_number | long | experimental The line number where the exception happened. | 1401 |
exception.message | string | stable A message that describes the exception. | Division by zero |
exception.stack_trace | string | experimental The stack trace of the exception. The format depends on the technology and source. While OneAgent formats stack traces to unify them across technologies, stack traces from an OpenTelemetry source are in the format they were sent to Dynatrace. | @https://www.foo.bar/path/main.js:59:26 e@https://www.foo.bar/path/lib/1.1/lib.js:2:30315 |
exception.type | string | stable The type of the exception, for example its fully-qualified class name. | java.net.ConnectException ; OSError |
Fields that can be expected from serverless functions or Function as a Service (FaaS) on various cloud platforms.
Attribute | Type | Description | Examples |
---|---|---|---|
faas.max_memory | long | resource experimental The amount of memory available to the serverless function in Bytes. | |
faas.name | string | resource experimental The name of the single function that this runtime instance executes. 1 | my-function ; myazurefunctionapp/some-function-name ; test_function |
faas.version | string | resource experimental The immutable version of the function being executed. 2 | 14 ; 254 |
This is the name of the function as configured/deployed on the FaaS platform and is usually different from the name of the callback
function (which may be stored in the code.namespace
/code.function
span attributes).
Value of the field depends on a cloud provider. This field is not set for Azure.
Attribute | Type | Description | Examples |
---|---|---|---|
faas.coldstart | boolean | experimental A boolean that is true if the serverless function is executed for the first time (aka cold-start). | |
faas.document.collection | string | experimental The table/collection name on which the operation above was executed. 1 | my-coll-name |
faas.document.name | string | experimental The identifier for the specific item that changed after executing the operation above. 2 | my-file.jpg ; 63eeb6e7d418cd98afb1c1d7 |
faas.document.operation | string | experimental Relevant only for "datasource" trigger. The operation type which triggered the function invocation. | delete |
faas.document.time | string | experimental The UTC ISO-8601 timestamp of the operation above. 3 | 2020-03-08T00:30:12.456Z |
faas.event.__key__ | string | stable Faas event attribute, the __key__ attribute in a Faas event represents the precise attribute name as received in the event. For example, it might be "faas.event.StackId" for the "StackId" attribute in an AWS CloudFormation event or "faas.event.IdentityPoolId" for the "IdentityPoolId" attribute in an AWS Cognito event. The value of this attribute is identical to the value received in the event. | arn:aws:cloudformation:us-west-2:123456789012:stack/MyStack/1a2b3c4d-5678-90ab-cdef-EXAMPLE11111 ; eu-west-1:12345678-1234-1234-1234-123456789012 |
faas.event_name | string | experimental The API action that triggered the faas event. 4 | ObjectCreated:Put (aws:s3) ; INSERT (aws:dynamodb) |
faas.event_source | string | experimental The cloud service that originated the event. | aws:cloudwatch ; aws:cloudformation |
faas.invoked_name | string | experimental The name of the invoked function. | my-function |
faas.invoked_provider | string | experimental The cloud provider of the invoked function. Will be equal to the invoked function's cloud.provider resource attribute. | alibaba_cloud |
faas.invoked_region | string | experimental The cloud region of the invoked function. 5 | eu-central-1 |
faas.trigger | string | experimental Type of the trigger which caused this function invocation. | datasource |
Relevant only for faas.trigger=datasource
trigger
Relevant only for faas.trigger=datasource
trigger
Relevant only for faas.trigger=datasource
trigger
The value of this attribute is specific to the service that generated the event.
Will be equal to the invoked function's cloud.region
resource attribute.
faas.document.operation
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
delete | delete |
edit | edit |
insert | insert |
faas.invoked_provider
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
alibaba_cloud | Alibaba Cloud |
aws | Amazon Web Services |
azure | Microsoft Azure |
gcp | Google Cloud Platform |
tencent_cloud | Tencent Cloud |
faas.trigger
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
datasource | A response to some data source operation such as a database or filesystem read/write. |
http | To provide an answer to an inbound HTTP request |
other | If none of the others apply |
pubsub | A function is set to be executed when messages are sent to a messaging system. |
timer | A function is scheduled to be executed regularly. |
Fields that can be expected for a failure detection on a Dynatrace span. For more details and how failure detection is embedded in a span, see Dynatrace Span model.
Attribute | Type | Description | Examples |
---|---|---|---|
dt.failure_detection.general_parameters_id | uid | experimental The id of the failure detection general parameters (failure detection v1) that were applied to that span (uid128). | 4d76194c11a9426197a9062548f9e66f |
dt.failure_detection.global_parameters_id | uid | experimental The id of the global failure detection parameters (failure detection v1) that were applied to that span (uid128).This is always used in conjunction with the dt.failure_detection.global_rule_id . | 4d76194c11a9426197a9062548f9e66c |
dt.failure_detection.global_rule_id | uid | experimental The id of the global failure detection rule (failure detection v1) that was applied to that span (uid128).This is always used in conjunction with the dt.failure_detection.global_parameters_id . | 4d76194c11a9426197a9062548f9e66b |
dt.failure_detection.http_parameters_id | uid | experimental The id of the failure detection HTTP parameters (failure detection v1) that were applied to that span (uid128). | 4d76194c11a9426197a9062548f9e66a |
dt.failure_detection.results | record[] | experimental A collection of individual failure detection reasons and verdicts for each applied matching rule. If no entries exist, no rules matched, and the attribute does not exist. | |
dt.failure_detection.ruleset_id | uid | experimental The id of the failure detection rule set (failure detection v2) that was applied to that span (uid128). | 4d76194c11a9426197a9062548f9e66e |
The event name MUST be feature_flag.evaluation
.
Attribute | Type | Description | Examples |
---|---|---|---|
feature_flag.context.id | string | experimental The unique identifier for the flag evaluation context. For example, the targeting key. | 5157782b-2203-4c80-a857-dbbd5e7761db |
feature_flag.key | string | experimental The unique identifier of the feature flag. | logo-color |
feature_flag.provider.name | string | experimental The name of the service provider that performs the flag evaluation. | Flag Manager |
feature_flag.result.reason | string | experimental The reason code, which shows how a feature flag value was determined. | static ; targeting_match ; error ; default |
feature_flag.result.variant | string | experimental A semantic identifier for an evaluated flag value. 1 | red ; true ; on |
feature_flag.set.id | string | experimental The identifier of the flag set to that the feature flag belongs. | proj-1 ; ab98sgs ; service1/dev |
feature_flag.version | string | experimental The version of the ruleset used during the evaluation. This can be any stable value that uniquely identifies the ruleset. | 1 ; 01ABCDEF |
A semantic identifier, commonly referred to as a variant, provides a means
for referring to a value without including the value itself. This can
provide additional context for understanding the meaning behind a value.
For example, the variant red
maybe be used for the value #c05543
.
feature_flag.result.reason
MUST be one of the following:
Value | Description |
---|---|
cached | The resolved value was retrieved from cache. |
default | The resolved value fell back to a pre-configured value (no dynamic evaluation occurred or dynamic evaluation yielded no result). |
disabled | The resolved value was the result of the flag being disabled in the management system. |
error | The resolved value was the result of an error. |
split | The resolved value was the result of pseudorandom assignment. |
stale | The resolved value is non-authoritative or possibly out of date. |
static | The resolved value is static (no dynamic evaluation). |
targeting_match | The resolved value was the result of a dynamic evaluation, such as a rule or specific user-targeting. |
unknown | The reason for the resolved value could not be determined. |
Attribute | Type | Description | Examples |
---|---|---|---|
gcp.app_engine.instance | string | resource experimental | |
gcp.app_engine.service | string | resource experimental | |
gcp.cloud_run.service | string | resource experimental | |
gcp.instance.id | string | resource experimental A permanent identifier that is unique within your Google Cloud project. | 6639848141313102286 |
gcp.instance.name | string | resource experimental The name to display for the instance in the Cloud Console. | single-vm-test |
gcp.location | string | resource stable Region or zone the instance of the GCP resource is running on. | europe-west3-c |
gcp.organization.id | string | resource experimental Unique, immutable identifier assigned to an organization resource. | 123456789012 |
gcp.organization.name | string | resource experimental Name assigned to the GCP organization. | dynatrace.com |
gcp.project.id | string | resource stable The identifier of the GCP project associated with this resource. Tags: permission primary-field | dynatrace-gcp-extension |
gcp.region | string | resource experimental A region is a specific geographical location where you can host your resources. Tags: primary-field | europe-west3 |
gcp.resource.name | string | resource experimental The globally unique resource name in Google Cloud Platform convention. | //cloudfunctions.googleapis.com/projects/gcp-example-project/locations/us-central1/functions/examplefunction |
gcp.resource.type | string | resource experimental The name of a resource type. | cloudsql_database |
gcp.zone | string | resource experimental A zone is a subset of a region. Each region has three or more zones. | europe-west3-c |
Attribute | Type | Description | Examples |
---|---|---|---|
gen_ai.guardrail.id | string | experimental Identifier of the guardrail that has been activated for the request. | sensitive_data_guardrail |
gen_ai.guardrail.version | string | experimental Version of the guardrail that has been activated. | DRAFT ; 5 ; 12345678 |
gen_ai.operation.name | string | experimental Name of operation being performed. | chat ; generate_content ; text_completion |
gen_ai.prompt_caching | string | experimental Indicates how prompt cache has been used when handling the request. | read ; write |
gen_ai.provider.name | string | experimental Name of GenAI product being used. | aws_bedrock ; openai |
gen_ai.request.frequency_penalty | double | experimental Frequency penalty setting for GenAI request. | 0.4 |
gen_ai.request.max_tokens | long | experimental Maximum number of tokens that the model can generate for a request. | 50 |
gen_ai.request.model | string | experimental Model chosen to handle the request. | amazon.nova-micro-v1:0 ; anthropic.claude-3-7-sonnet-20250219-v1:0 |
gen_ai.request.presence_penalty | double | experimental Presence penalty setting for GenAI request. | 0.4 |
gen_ai.request.stop_sequences | string[] | experimental List of sequences that will stop the model from generating further tokens. | [forest, lived] |
gen_ai.request.temperature | double | experimental Temperature setting for GenAI request. | 0.8 |
gen_ai.request.top_k | long | experimental Temperature setting for GenAI request. | 300 |
gen_ai.request.top_p | double | experimental Temperature setting for GenAI request. | 0.6 |
gen_ai.response.finish_reasons | string[] | experimental List of reasons why the model stopped generating tokens, corresponding to each generation received. | [["stop_sequence"], ["stop_sequence", "max_tokens"]] |
gen_ai.response.model | string | experimental Model that handled the request. | amazon.nova-micro-v1:0 ; anthropic.claude-3-7-sonnet-20250219-v1:0 |
gen_ai.usage.input_tokens | long | experimental Number of tokens sent to the model in the request. | 42 |
gen_ai.usage.output_tokens | long | experimental Number of tokens generated by the model while handling the request. | 42 |
gen_ai.prompt_caching
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
read | Cache hit. Reading from cache. |
write | Cache miss. Creating cache checkpoint. |
The geo namespace contains geo location information. This section only holds all currently agreed upon fields in the Dynatrace Semantic Dictionary. Aligned closely to the ECS, with some adaptions around field groupings
Attribute | Type | Description | Examples |
---|---|---|---|
geo.city.name | string | resource stable English name of the city. | Montreal |
geo.continent.name | string | resource stable English name of the continent. | North America |
geo.country.iso_code | string | resource experimental The two-letter country code. The format complies with ISO 3316-1 alpha-2. | CA ; GB |
geo.country.name | string | resource stable English name of the country. | Canada |
geo.location.latitude | double | resource experimental The approximate latitude. The format complies with WGS 84. | 45.505918 |
geo.location.longitude | double | resource experimental The approximate longitude. The format complies with WGS 84. | -73.61483 |
geo.region.name | string | resource stable English name of the region. | Quebec |
Attribute | Type | Description | Examples |
---|---|---|---|
glassfish.domain.name | string | resource experimental The name of the domain this instance belongs to. | |
glassfish.instance.name | string | resource experimental The instance's name. |
Attribute | Type | Description | Examples |
---|---|---|---|
go.linkage | string | resource experimental |
Fields describing a host.
Dynatrace aims to use the best fitting name for the field host.name
. See below, how Dynatrace determines the host name in an ordered by precedence fashion:
Dynatrace supports customizing the host.name
property. A custom set host name takes precedence over the auto detection mechanisms described further down.
oneagentctl
tool can be used to set a custom host name. See Documentation for details.If no customized name is set locally, the OneAgent attempts to determine if we're deployed by Dynatrace Operator in Kubernetes or OpenShift and sets host.name
to the name of the Node.
If the Kubernetes isn't present, the OneAgent attempts to determine the host.name
value by accessing cloud metadata where applicable.
name
(case insensitive) is found, the tag's value is used as the host.name
.name
(case insensitive) instance metadata property is used. See Microsoft Azure documentationhostname
instance metadata property is used. See Google Cloud documentation.gethostname()
if it can be interpreted as a fully qualified domain name (FQDN) and doesn't contain "localhost".getaddrinfo()
for port 80 is issued, again sanity checking whether the returned name is an FQDN and doesn't contain "localhost".gethostname()
was successful, and the returned string is not empty and doesn't contain "localhost", then it's used.EmptyHostName
if neither property can be resolved.GetComputerNameExA
is used to determine a host's name. In particular, the resulting name is composed of <hostname>.<domainname>
with the following details
hostname
= ComputerNameDnsHostname retrieved by GetComputerNameExdomainname
= ComputerNameDnsDomain retrieved by GetComputerNameExGetComputerNameExA
is used when it can be interpreted as a fully qualified domain name (FQDN).GetComputerNameExA
is used when it's not empty.EmptyHostName
if neither property can be resolved.Attribute | Type | Description | Examples |
---|---|---|---|
host.fqdn | string[] | resource experimental A list of FQDNs of this host. | [ec2-43-213-176-3.compute-1.amazonaws.com, localhost.example.com] |
host.ip | ipAddress[] | resource experimental A list of IP adresses (IPv4 or IPv6) of this host. | [194.232.104.141, 2a01:468:1000:9::140] |
host.logical.cpu.cores | long | resource experimental Logical CPU cores on the monitored host. | 8 |
host.logical.cpus | long | resource experimental Logical CPUs on the monitored host. Applies to AIX LPARs. | 8 |
host.mac | array | resource experimental A list of MAC adresses associated with this host. | 4C:03:4F:5B:E8:89 ; 00:15:5D:2F:1C:2A |
host.name | string | resource experimental The host name as determined on the data source (for instance, OneAgent, extensions or OpenTelemetry). Important: This is not the name of the host entity, which can be modified based on naming rules. Tags: permission | ip-10-178-54-32.ec2.internal |
host.physical.memory | long | resource experimental Physical memory of the monitored host, expressed in bytes. The value might be different than the total available memory, if features such as Active Memory Expansion are used. | 8141684736 |
host.simultaneous.multithreading | long | resource experimental Number of threads for AIX Simultaneous Multithreading feature. | 4 |
host.virtual.cpus | long | resource experimental Number of virtual CPUs for AIX LPAR. | 2 |
Attribute | Type | Description | Examples |
---|---|---|---|
http.request.body.size | long | stable The size of the request payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the Content-Length header. For requests using transport encoding, this should be the compressed size. | 3495 |
http.request.header.__key__ | string | stable HTTP request headers, __key__ being the lowercase HTTP header name, for example "http.request.header.accept-encoding". The value is a string. If multiple headers have the same name or multiple header values, the values will be comma-separated into a single string.Tags: sensitive-spans | https://www.foo.bar/ ; gzip, deflate, br ; 1.2.3.4, 1.2.3.5 |
http.request.id | string | experimental String that uniquely identifies a request. | SOX4xwn4XV6Q4rgb7XiVGOHms_BGlTAC4KyHmureZmBNrjGdRLiNIQ== ; k6WGMNkEzR5BEM_SaF47gjtX9zBDO2m349OY2an0QPEaUum1ZOLrow== |
http.request.method | string | stable HTTP request method. | GET ; POST ; HEAD |
http.request.parameter.__key__ | string | stable HTTP request parameters, __key__ for example, "http.request.parameter.username". The value is a string. If there are multiple parameters with the same name or multiple parameter values, the values will be a single, comma-separated string. | admin ; premium |
http.request.size | long | experimental The total size of the request in bytes. This value should be the total number of bytes sent over the wire, including the request line (HTTP/1.1), framing (HTTP/2 and HTTP/3), headers, and request body if any. | 114 ; 702 |
http.response.body.size | long | stable The size of the response payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the Content-Length header. For requests using transport encoding, this should be the compressed size. | 3495 |
http.response.header.__key__ | string | stable HTTP response headers, __key__ being the lowercase HTTP header name, for example, "http.response.header.content-type". The value is a string. If multiple headers have the same name or multiple header values, the values will be comma-separated into a single string. | 909 ; text/html; charset=utf-8 ; abc, def |
http.response.range_end_value | long | experimental When the response contains the HTTP Content-Range header, this field contains the range end value. | 499 ; 1999 |
http.response.range_start_value | long | experimental When the response contains the HTTP Content-Range header, this field contains the range start value. | 0 ; 1000 |
http.response.reason_phrase | string | experimental The HTTP reason phrase (HTTP1 only). | Not found |
http.response.size | long | experimental The total size of the response in bytes. This value should be the total number of bytes sent over the wire, including the status line (HTTP/1.1), framing (HTTP/2 and HTTP/3), headers, and response body and trailers if any. | 251 ; 608 |
http.response.status_code | long | stable HTTP response status code. | 200 |
http.response.time_to_first_byte | double | experimental Time between the browser requesting a page and when it receives the first byte of information from the server. | 0.022 ; 0.071 |
http.route | string | stable The matched route (path template in the format used by the respective server framework). | /users/:userID? ; Home/Index/{id?} |
Attribute | Type | Description | Examples |
---|---|---|---|
http.server_name | string | resource experimental The server name as configured by the webserver if available. If no such name exists, this is the local hostname and bound port. In Kubernetes, the base pod name is used. | MyServer ; localhost:8000 |
Attribute | Type | Description | Examples |
---|---|---|---|
hybris.bin.dir | string | resource experimental | /opt/hybris-60/hybris/bin |
hybris.config.dir | string | resource experimental | /opt/hybris-60/hybris/config |
hybris.data.dir | string | resource experimental | /opt/hybris-60/hybris/data |
Attribute | Type | Description | Examples |
---|---|---|---|
ibm.ace.integration_node.name | string | resource experimental The name of the integration node (broker) that manages one or more integration servers. | myIntegrationNode ; YourBroker ; the_management_instance |
ibm.ace.integration_server.name | string | resource experimental The name of the broker-managed or standalone integration server (formerly known as execution group or dataflow engine). | myIntegrationServer ; YourExecutionGroup ; dataflow_engine |
ibm.cics.aor | string | resource experimental | |
ibm.cics.program | string | resource experimental The name of the CICS program. | EDUCHAN |
ibm.cics.region | string | resource experimental | |
ibm.cics.tor | string | resource experimental | |
ibm.ctg.name | string | resource experimental | |
ibm.ims.connect | string | resource experimental | |
ibm.ims.control | string | resource experimental | |
ibm.ims.mpr | string | resource experimental | |
ibm.ims.soap_gw.name | string | resource experimental |
Attribute | Type | Description | Examples |
---|---|---|---|
iis.app_pool.name | string | resource experimental | |
iis.role.name | string | resource experimental |
Attribute | Type | Description | Examples |
---|---|---|---|
java.jar.file | string | resource experimental | |
java.jar.path | string | resource experimental | |
java.main.class | string | resource experimental | |
java.main.module | string | resource experimental |
Attribute | Type | Description | Examples |
---|---|---|---|
jboss.home | string | resource experimental The instance's home directory. | |
jboss.mode | string | resource experimental The instance's operating mode. | org.jboss.as.standalone ; org.jboss.as.server |
jboss.server.name | string | resource experimental The instance's server name. |
Attribute | Type | Description | Examples |
---|---|---|---|
jdbc.connection.pool.name | string | stable The name of the JDBC connection pool. | jdbc/db2 |
Attribute | Type | Description | Examples |
---|---|---|---|
journald.unit | string | experimental A unit is a systemd object that performs or controls a particular task or action; concerns unix-based systems | cron.service ; oneagent.service ; kubepods.slice |
Attribute | Type | Description | Examples |
---|---|---|---|
k8s.cluster.name | string | resource stable (Optional) The user-defined name of the cluster in Dynatrace. Doesn't need to be unique or immutable. Tags: permission primary-field | unguard-dev ; acme-prod10 |
k8s.cluster.uid | string | resource stable A pseudo-ID for the cluster, by default set to the UID of the kube-system namespace. | 1c7a24c7-ff51-46e0-bcc9-c52637ceec57 |
k8s.configmap.name | string | resource experimental Name of the ConfigMap. | my-configmap |
k8s.container.name | string | resource stable The name of the container from the pod specification; must be unique within a pod. Container runtime usually uses different globally unique name ( container.name ). | redis |
k8s.cronjob.name | string | resource experimental Name of the CronJob. | my-cronjob |
k8s.customresourcedefinition.name | string | resource experimental Name of the CustomResourceDefinition. | dynakubes.dynatrace.com |
k8s.daemonset.name | string | resource experimental Name of the DaemonSet. | my-daemonset |
k8s.deployment.name | string | resource experimental Name of the Deployment. | my-deployment |
k8s.deploymentconfig.name | string | resource experimental Name of the DeploymentConfig. | my-deploymentconfig |
k8s.dynakube.name | string | resource experimental Name of the DynaKube. | my-dynakube |
k8s.edgeconnect.name | string | resource experimental Name of the EdgeConnect. | my-edgeconnect |
k8s.ingress.name | string | resource experimental Name of the Ingress. | my-ingress |
k8s.job.name | string | resource experimental Name of the Job. | my-job |
k8s.namespace.name | string | resource stable The name of the namespace that the pod is running in. Tags: permission primary-field | default ; kube-system |
k8s.namespace.uid | string | resource experimental The UID of the namespace. | bfb1ba44-3bcb-467d-a2dc-188fd74d1db5 |
k8s.networkpolicy.name | string | resource experimental Name of the NetworkPolicy. | my-networkpolicy |
k8s.node.name | string | resource stable Name of the node. | cluster-pool-1-c3c7423d-azth |
k8s.persistentvolume.name | string | resource experimental Name of the PersistentVolume. | my-persistentvolume |
k8s.persistentvolumeclaim.name | string | resource experimental Name of the PersistentVolumeClaim. | my-persistentvolumeclaim |
k8s.pod.name | string | resource stable The name of the pod. | checkoutservice-7895755b94-mzs5m |
k8s.pod.uid | string | resource stable The UID of the pod. | 275ecb36-5aa8-4c2a-9c47-d8bb681b9aff |
k8s.replicaset.name | string | resource experimental Name of the ReplicaSet. | my-replicaset |
k8s.replicationcontroller.name | string | resource experimental Name of the ReplicationController. | my-replicationcontroller |
k8s.secret.name | string | resource experimental Name of the Secret. | my-secret |
k8s.service.name | string | resource stable The name of the Kubernetes service. | my-service |
k8s.statefulset.name | string | resource experimental Name of the StatefulSet. | my-statefulset |
k8s.workload.kind | string | resource stable The type of the workload. The value is the Kubernetes object kind of the workload in lowercase. | deployment ; statefulset ; cronjob ; job ; daemonset ; replicaset |
k8s.workload.name | string | resource stable The name of the workload. | checkoutservice |
k8s.workload.uid | string | resource experimental The UID of the workload. | 786a41e4-e673-44bb-bb30-18888f797a2b |
Attribute | Type | Description | Examples |
---|---|---|---|
k8s.namespace.annotation.__attribute_name__ | string | resource experimental Kubernetes namespace annotation that should be enriched on ingest signals and service metrics. The attribute_name is a placeholder that can freely be chosen. | k8s.namespace.annotation.team=a_team |
k8s.namespace.label.__attribute_name__ | string | resource experimental Kubernetes namespace label that should be enriched on ingest signals and service metrics. The attribute_name is a placeholder that can freely be chosen. | k8s.namespace.label.env=dev |
k8s.pod.annotation.__attribute_name__ | string | resource experimental Kubernetes pod annotation that should be enriched on ingest signals and service metrics. The attribute_name is a placeholder that can freely be chosen. | k8s.pod.annotation.team=a_team |
k8s.pod.label.__attribute_name__ | string | resource experimental Kubernetes pod label that should be enriched on ingest signals and service metrics. The attribute_name is a placeholder that can freely be chosen. | k8s.pod.label.env=dev |
k8s.workload.annotation.__attribute_name__ | string | resource experimental Kubernetes workload annotation that should be enriched on ingest signals and service metrics. The attribute_name is a placeholder that can freely be chosen. | k8s.workload.annotation.team=a_team |
k8s.workload.label.__attribute_name__ | string | resource experimental Kubernetes workload label that should be enriched on ingest signals and service metrics. The attribute_name is a placeholder that can freely be chosen. | k8s.workload.label.env=dev |
Fields relevant for log events
Attribute | Type | Description | Examples |
---|---|---|---|
log.file.name | string | experimental The basename of the file. | messages ; agent.log |
log.file.path | string | experimental The full path to the file. | /var/log/messages ; /var/log/dynatrace/agent.log |
log.iostream | string | stable The I/O stream to which the log was emitted. | stdout ; stderr |
log.logger | string | experimental The name of the logger inside an application. This name is usually the name of the class that initialized the logger, but it can be a custom name. | main.logger ; kafka.server.KafkaServer |
log.raw_level | string | experimental The original severity level of the log entry as recorded by the source, before standardization into the log.level format. 1 | silly ; verbose |
log.source | string | stable Human-readable attribute that identifies a log stream. 2 Tags: permission | /var/log/messages ; Windows Event Log ; Docker Container Output ; stdout |
log.source.origin | string | stable The log source origin indicates where the log derives from. | CUSTOM ; IIS_LOG_DETECTOR |
loglevel | string | stable The log event severity level. | ERROR ; INFO ; TRACE |
The log.raw_level can vary in type depending on the log entry. It may be represented as a string in some cases or as an integer (for example, 30, 40, 50) in others.
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).
log.iostream
MUST be one of the following:
Value | Description |
---|---|
stderr | std_err |
stdout | std_out |
log.source.origin
MUST be one of the following:
Value | Description |
---|---|
CONTAINER_LOG_DETECTOR | Container log detector. |
CUSTOM_LOG | Custom log source configuration. |
IIS_LOG_DETECTOR | IIS log detector. |
JOURNALD_LOG_DETECTOR | Journald log detector. |
OPEN_LOG_DETECTOR | Open log file detector. |
SYSTEM_LOG_DETECTOR | System log detector. |
loglevel
MUST be one of the following:
Value | Description |
---|---|
ALERT | alert |
CRITICAL | critical |
DEBUG | debug |
EMERGENCY | emergency |
ERROR | error |
FATAL | fatal |
INFO | info |
NONE | none |
NOTICE | notice |
SEVERE | severe |
TRACE | trace |
WARN | warn |
Attribute | Type | Description | Examples |
---|---|---|---|
messaging.batch.failed_count | long | experimental The number of messages in the batch for which publishing failed. | 1 ; 3 ; 15 |
messaging.batch.failure_codes | string[] | experimental The vendor-provided error codes explaining why an operation on the message broker failed. To limit attribute size, not all error codes might be included. | [['MalformedDetail', 'InvalidArgument']] |
messaging.batch.message_count | long | experimental The number of messages sent, received, or processed in the scope of the batching operation. | 1 ; 2 ; 3 |
messaging.client.id | string | experimental A unique identifier for the client that consumes or produces a message. | aclient ; myhost@68d46b89c9-c29qc |
messaging.consumer.group.name | string | experimental The name of the consumer group with which a consumer is associated. | my-group ; indexer |
messaging.destination.kind | string | deprecated The kind of message destination | queue ; topic |
messaging.destination.manager_name | string | experimental The destination's manager name 1 | MyBroker |
messaging.destination.name | string | experimental The message destination name 2 | MyQueue ; MyTopic |
messaging.destination.partition.id | string | experimental String representation of the partition ID the message is sent to or received from. | 1 |
messaging.destination.temporary | boolean | experimental A boolean that is true if the message destination is temporary and might not exist anymore after messages are processed. | |
messaging.message.body.size | long | experimental The (uncompressed) size of the message payload in bytes. | 2738 |
messaging.message.conversation_id | string | experimental The conversation ID identifying the conversation to which the message belongs, represented as a string. Sometimes called "Correlation ID". | MyConversationId |
messaging.message.header.__key__ | record | experimental The message headers, __key__ being the message header/attribute name, for example, "messaging.message.header.ExtendedPayloadSize". The data type of the value depends on the attribute. | 1024, "my-eu-bucket-3", ["a", "b"] |
messaging.message.id | string | experimental A value used by the messaging system as an identifier for the message, represented as a string. | 452a7c7c7c7048c2f887f61572b18fc2 |
messaging.operation.type | string | experimental A string identifying the kind of messaging operation. | peek |
messaging.source.kind | string | deprecated The kind of message source | queue ; topic |
messaging.source.manager_name | string | deprecated Replaced by messaging.destination.manager_name .The source's manager name 3 | MyBroker |
messaging.source.name | string | deprecated Replaced by messaging.destination.name .The message source name 4 | MyQueue ; MyTopic |
messaging.source.temporary | boolean | deprecated Replaced by messaging.destination.temporary .A boolean that is true if the message source is temporary and might not exist anymore after messages are processed. | |
messaging.system | string | experimental An identifier for the messaging system. See below for a list of well-known identifiers. | kafka ; rabbitmq |
Manager name uniquely identifies the broker.
Destination name uniquely identifies a specific queue, topic or other entity within the broker.
Manager name uniquely identifies the broker.
Source name uniquely identifies a specific queue, topic, or other entity within the broker.
messaging.destination.kind
MUST be one of the following:
Value | Description |
---|---|
queue | A message sent to or received from a queue |
topic | A message sent to or received from a topic |
messaging.operation.type
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
peek | A message is received from a destination by a message consumer/server, but left there (span.kind is "consumer"). |
process | A message previously received from a destination is processed by a message consumer (span.kind is "consumer"). |
publish | A message is sent to a destination by a message producer (span.kind is "producer"). |
receive | A message is received from a destination by a message consumer (span.kind is "consumer"). |
messaging.source.kind
MUST be one of the following:
Value | Description |
---|---|
queue | A message received from a queue |
topic | A message received from a topic |
messaging.system
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
activemq | ActiveMQ |
artemis | ActiveMQ Artemis |
aws_eventbridge | Amazon EventBridge |
aws_sns | Amazon Simple Notification Service (SNS) |
aws_sqs | Amazon Simple Queue Service (SQS) |
azure_eventgrid | Azure Event Grid |
azure_eventhubs | Azure Event Hubs |
azure_servicebus | Azure Service Bus |
gcp_pubsub | Google Cloud Pub/Sub |
hornetq | HornetQ |
jms | Java Message Service |
kafka | Apache Kafka |
mqseries | IBM MQ |
msmq | MSMQ |
rabbitmq | RabbitMQ |
rocketmq | Apache RocketMQ |
sag_webmethods_is | Software AG, webMethods Integration Server |
tibco_ems | Tibco EMS |
weblogic | Oracle WebLogic |
websphere | IBM WebSphere Application Server |
Attribute | Type | Description | Examples |
---|---|---|---|
messaging.akka.actor.kind | string | experimental Name of the top-level actor. See The Akka actor hierarchy | system ; user |
messaging.akka.actor.path | string | experimental Path to actor inside actor system. | /system/log1-Logging$DefaultLogger ; /remote/akka.tcp/RequesterSystem@localhost:52133/user/requestActor/$a |
messaging.akka.actor.system | string | experimental Name of the actor system. | RequesterSystem ; ResponseSystem |
messaging.akka.actor.type | string | experimental Fully qualified type name of actor. | com.acme.RespondingActor |
messaging.akka.message.type | string | experimental Fully qualified type name of the message. | java.lang.String ; akka.event.Logging$Info2 ; com.acme.twosuds.ResponseActor$RequestMessage |
Attribute | Type | Description | Examples |
---|---|---|---|
messaging.kafka.message.key | string | experimental The key property of the message. | mykey |
messaging.kafka.message.tombstone | boolean | experimental A boolean that is true if the message is a tombstone. 1 | true |
messaging.kafka.offset | long | experimental The offset of the message. | 42 |
If the message is a tombstone, the value is true
. When missing, the value is assumed to be false
.
In webserver technologies a multitude of modules might be contributing to handling a single web request. Module insights provides timings for these, where available.
Attribute | Type | Description | Examples |
---|---|---|---|
module_insights.modules | record | experimental Modules executed as part of this web request, represented as map from module name to duration in nanoseconds spent. | {'HttpRedirectionModule': 10299, 'BasicAuthenticationModule': 4665} |
These attributes may be used for any network related operation.
Attribute | Type | Description | Examples |
---|---|---|---|
network.carrier.name | string | experimental The mobile carrier name. | Magenta ; AT&T |
network.connection.subtype | string | experimental Further details that specify network.connection.type , such as the cellular or WI-FI technology. | lte ; 802.11x |
network.connection.type | string | experimental The internet connection type. | cell ; wifi |
network.protocol.name | string | stable OSI Application Layer or non-OSI equivalent. | amqp ; http ; mqtt |
network.protocol.version | string | experimental Version of the application layer protocol used. | 1.1 ; 3.1.1 |
network.transport | string | stable OSI Transport Layer or Inter-process Communication method | tcp ; udp |
network.type | string | stable OSI Network Layer or non-OSI equivalent. | ipv4 ; ipv6 |
network.connection.type
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
cell | cell |
unavailable | unavailable |
unknown | unknown |
wifi | wifi |
wired | wired |
network.transport
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
inproc | In-process communication. 1 |
other | Something else (non-IP-based). |
pipe | Named or anonymous pipe. |
tcp | TCP |
udp | UDP |
unix | Unix domain socket. |
Signals that there is only in-process communication not using a "real" network protocol in cases where network attributes would typically be expected. Usually, all other network attributes can be left out.
network.type
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
ipv4 | IPv4 |
ipv6 | IPv6 |
Fields that are used in extensions to describe network devices.
Attribute | Type | Description | Examples |
---|---|---|---|
device | string | resource deprecated Used in Extension Framework 2.0 Address (IP address with port) used by a monitored device to communicate with an extension. | 10.102.0.45:161 |
device.address | ipAddress | resource deprecated Used in Extension Framework 2.0 IP address used by a monitored device to communicate with an extension. | 10.102.0.45 |
device.name | string | resource deprecated Used in Extension Framework 2.0 Name of a device monitored by an extension. | AT1i-WLC-TestingLab.dynatrace.org |
device.port | string | resource deprecated Used in Extension Framework 2.0 Port used by a monitored device to communicate with an extension. | 161 |
Fields relevant for network flows
Attribute | Type | Description | Examples |
---|---|---|---|
network_flow.bytes.rx | long | experimental Number of received bytes (octets). | |
network_flow.bytes.tx | long | experimental Number of transmitted bytes (octets). | |
network_flow.destination.address | string | experimental Destination IP address | 192.33.1.2 ; 2001:0db8:85a3:0000:0000:8a2e:0370:7334 |
network_flow.destination.port | string | experimental Flow destination port. | 22 ; 8080 |
network_flow.direction | string | experimental IP source address is TCP client or server. | SrcIsClient |
network_flow.network.transport | string | experimental Protocol | TCP ; other ; UDP |
network_flow.network.type | string | experimental IP protocol version. | IPV4 |
network_flow.packets.retransmitted.base.rx | long | experimental Number of packets sent from the destination to the source used as the base for retransmission rate. | |
network_flow.packets.retransmitted.base.tx | long | experimental Number of packets sent from the source to the destination used as the base for retransmission rate. | |
network_flow.packets.retransmitted.rx | long | experimental Number of retransmitted packets sent from the destination to the source. | |
network_flow.packets.retransmitted.tx | long | experimental Number of retransmitted packets from source to destination. | |
network_flow.packets.rx | long | experimental Number of received packets. | |
network_flow.packets.tx | long | experimental Number of transmitted packets. | |
network_flow.source.address | string | experimental Source IP address | 192.33.1.2 ; 2001:0db8:85a3:0000:0000:8a2e:0370:7334 |
network_flow.tcp.rtt | long | experimental Mean RTT value. | |
network_flow.tcp.rtt.ack | long | experimental Mean RTT ack value. | |
network_flow.tcp.sessions.new | long | experimental Number of new TCP sessions in the flow. | |
network_flow.tcp.sessions.reset | long | experimental Number of reset (rejected) TCP sessions in the flow. | |
network_flow.tcp.sessions.timeout | long | experimental Number of timed out TCP sessions in flow. |
network_flow.direction
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
SrcIsClient | IP source is TCP client |
SrcIsServer | IP source is TCP server |
UNKNOWN | TCP session initializer is unknown |
network_flow.network.type
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
IPV4 | ipv4 |
IPV6 | ipv6 |
Attribute | Type | Description | Examples |
---|---|---|---|
nodejs.app.base.dir | string | resource experimental | |
nodejs.app.name | string | resource experimental | |
nodejs.script.name | string | resource experimental |
Fields that can come from applications running on OpenStack.
Attribute | Type | Description | Examples |
---|---|---|---|
openstack.availability_zone | string | resource experimental A specific availability zone in the given OpenStack region. | us-east-1a |
openstack.instance_uuid | string | resource experimental UUID of specific OpenStack instance. | 6790cb48-f8e9-4773-bcea-001469de0599 |
The origin of a request associated with this event.
Attribute | Type | Description | Examples |
---|---|---|---|
origin.address | string | experimental Source IP address of the request associated with this event. Must be set if origin.type is 'REST', must not be set otherwise. | 10.11.12.13 |
origin.session | string | experimental The ID of the browser session (if present) associated with the event. | node0hfznc |
origin.type | string | experimental Origin type of the request associated with this event. | REST ; LOCAL |
origin.x_forwarded_for | string | experimental The verbatim value of the X-Forwarded-For HTTP request header (if present) of the request associated with the event. | 1.2.3.4 |
origin.type
MUST be one of the following:
Value | Description |
---|---|
LOCAL | The event provider issued the request locally. |
RECOVERY | The event provider issued the request locally as part of disaster recovery. |
REST | The event provider received an external REST API call. |
The os namespace contains information on the operating system running an application.
Attribute | Type | Description | Examples |
---|---|---|---|
os.architecture | string | resource experimental Architecture of the CPU, discovered from the operating system. | X86 |
os.name | string | resource stable The OS name in a short, human-readable format. | iOS |
os.type | string | resource experimental Type of discovered operating system. | LINUX ; WINDOWS |
os.version | string | resource stable The complete OS version, including patch, build, and other information. | 15.3.1 ; Ubuntu 16.04.7 LTS (Xenial Xerus) (kernel 4.15.0-206-generic) ; Windows Server 2022 Datacenter 21H2 2009, ver. 10.0.20348 |
Attribute | Type | Description | Examples |
---|---|---|---|
otel.scope.name | string | experimental The name of the instrumentation scope - ( InstrumentationScope.Name in OTLP). | io.opentelemetry.contrib.mongodb |
otel.scope.version | string | experimental The version of the instrumentation scope - ( InstrumentationScope.Version in OTLP). | 1.0.0 |
The page namespace contains information on the web page of an event.
Attribute | Type | Description | Examples |
---|---|---|---|
page.background_time | duration | experimental The aggregated time that the page was in the background. | 0 |
page.detected_name | string | experimental The name RUM JavaScript detected for the page. The value is based on page.url.full . | #dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e |
page.foreground_time | duration | experimental The aggregated time that the page was in the foreground. | 900000000 |
page.id | uid | experimental A random ID that is generated every time a user navigates to a new page. The page.id is an 8-byte ID and hex-encoded if shown as a string. | f76281848bd8288c |
page.name | string | experimental An identifier for grouping pages. The value is automatically calculated by Dynatrace from page.detected_name . | #dashboard;id=<uuid> |
page.prerender_time | duration | experimental The aggregated time that the page was prerendering. | 0 |
page.source.url.domain | string | experimental The URI host component of the source page URL. This is extracted from page.source.url.full . | www.foo.bar |
page.source.url.fragment | string | experimental The URI fragment component of the source page URL. This is extracted from page.source.url.full . | #dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
page.source.url.full | string | experimental The page URL of the previous page, provided in the format scheme://host[:port]/path[?query][#fragment] . This value is captured using document.referrer and may be missing or incomplete. | https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
page.source.url.path | string | experimental The URI path component of the source page URL. This is extracted from page.source.url.full . | /path |
page.source.url.query | string | experimental The URI query component of the source page URL. This is extracted from page.source.url.full . | q=value |
page.source.url.scheme | string | experimental The URI scheme component of the source page URL. This is extracted from page.source.url.full . | https ; http |
page.title | string | experimental The HTML DOM document.title property. | FooBar - Title |
page.url.domain | string | experimental The URI host component of the page URL. This is extracted from page.url.full . | www.foo.bar |
page.url.fragment | string | experimental The URI fragment component of the page URL. This is extracted from page.url.full . | dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
page.url.full | string | experimental The page URL, provided in the format scheme://host[:port]/path[?query][#fragment] . | https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
page.url.path | string | experimental The URI path component of the page URL. This is extracted from page.url.full . | /path |
page.url.query | string | experimental The URI query component of the page URL. This is extracted from page.url.full . | q=value |
page.url.scheme | string | experimental The URI scheme component of the page URL. This is extracted from page.url.full . | https ; http |
Attribute | Type | Description | Examples |
---|---|---|---|
php.cli.script.path | string | resource experimental | |
php.cli.working.dir | string | resource experimental | |
php.drupal.application.name | string | resource experimental | |
php.fpm.pool.name | string | resource experimental | |
php.symfony.application.name | string | resource experimental | |
php.wordpress.blog.name | string | resource experimental also see https://developer.wordpress.org/reference/functions/get_bloginfo/ |
Attribute | Type | Description | Examples |
---|---|---|---|
postgresql.session.id | string | experimental A unique ID to identify a PostgreSQL database session. | 00112233-4455-6677-8899-aabbccddeeff |
Primary Grail tags are a small set of important, customer-selected tags—such as Kubernetes labels, AWS/Azure tags, or key organizational attributes—that Dynatrace automatically attaches to all raw telemetry data at ingest, using the primary_tags.*
prefix. This enrichment enables fast, consistent filtering, grouping, and permission management across all data, without complex joins or proprietary tagging rules. Primary Grail tags are centrally configured and ensure that cloud-native and business-relevant metadata is always available for queries, dashboards, and access control.
Attribute | Type | Description | Examples |
---|---|---|---|
primary_tags.__key__ | string | resource experimental Primary Grail tags are used to tag a resource in a meaningful way. __key__ is populated with the tag name, for example, primary_tags.ownership . In case of single-value tags, the value is a string. In case of multi-value tags, the value is an array of strings. | team-alpha ; team-bravo |
Attribute | Type | Description | Examples |
---|---|---|---|
process.bitness | string | resource experimental The architecture of the monitored entity in terms of how many bits compose a basic value. | 64 |
process.containerized | boolean | resource experimental True if given process is running inside container. | |
process.executable.name | string | resource experimental The name of the process executable. On Linux based systems, can be set to the Name in proc/[pid]/status . On Windows, can be set to the base name of GetProcessImageFileNameW . | otelcol |
process.executable.path | string | resource experimental The full path to the process executable. On Linux-based systems, can be set to the target of proc/[pid]/exe . On Windows, can be set to the result of GetProcessImageFileNameW . | /usr/bin/cmd/otelcol |
process.listen_ports | array | resource experimental An array of open listen ports. | 50000 ; 50001 ; 50002 ; 50003 |
process.metadata | record | resource experimental It contains a diagnostic collection of input parameters that were used or could have been used in assigning processes to the process entity. | NODE_JS_APP_BASE_DIRECTORY:C:/home/site/wwwroot |
process.pid | long | resource experimental Process Identifier (PID) as observed by the monitored process. | 1234 |
Attribute | Type | Description | Examples |
---|---|---|---|
rabbitmq.function.arity | long | experimental The number of arguments the rabbitmq.function.name takes. | 2 ; 5 |
rabbitmq.function.name | string | experimental The name of the RabbitMQ function within the rabbitmq.module.name that generated the log entry. | start_it ; main |
rabbitmq.module.name | string | experimental The name of the RabbitMQ module that generated the log entry. | rabbit ; my_module |
rabbitmq.pid | string | experimental ID of the Erlang process. | 0.58.0 ; 1.20.4 |
The react_native namespace contains information on React Native details of an event.
Attribute | Type | Description | Examples |
---|---|---|---|
react_native.bundle.name | string | resource experimental The name of the React Native bundle. | RNBundleName |
react_native.bundle.version | string | resource experimental The version of the React Native bundle. | 0.0.1 |
Attribute | Type | Description | Examples |
---|---|---|---|
redis.role | string | experimental The role of the Redis process (for example, 'M' for Master or 'X' for sentinel). | C |
redis.role
MUST be one of the following:
Value | Description |
---|---|
C | Child process for persistence (RDB/AOF). |
M | Master Redis process. |
R | Replica Redis process. |
X | Sentinel monitoring process. |
Attribute | Type | Description | Examples |
---|---|---|---|
request.is_failed | boolean | experimental Indicates that the request is considered failed according to the failure detection rules. Only present on the request root span. | |
request.is_root_span | boolean | experimental Marks the root of a request. It's the first span and starts the request within a service. |
Request scoped attributes (e.g. method parameters, return values, class names, …) captured by the OneAgent based on a request attribute definition. The actual name of the attribute is the prefix "request_attribute" plus the "request attribute name" defined in the request attributes configuration. Request attributes are built based on captured attributes and other attributes like HTTP header values or "normal" span attributes, on which the aggregations (first/last value, distinct values, ...), type conversion and normalizations defined in the request attribute configuration are performed. They are evaluated for an entire request (possibly consisting of multiple spans) and are stored only on the request root node.
Attribute | Type | Description | Examples |
---|---|---|---|
request_attribute.__attribute_name__ | array | stable Contains the request scoped reconciled values of the attribute named __attribute_name__ defined by the request attribute configuration. The data type of the value depends on the request attribute definition.Tags: sensitive-spans | 42 ; Platinum ; ['Product A', 'Product B'] ; ['Special Offer', '1702'] |
Attribute | Type | Description | Examples |
---|---|---|---|
rpc.method | string | experimental The name of the (logical) method being called 1 | exampleMethod |
rpc.namespace | string | experimental The namespace of the method being called. In SOAP, it would be the XML namespace. | tempuri.org |
rpc.service | string | experimental The full (logical) name of the service being called, including its package name, if applicable. 2 | myservice.EchoService |
rpc.system | string | experimental A string identifying the remoting system or framework. See below for a list of well-known identifiers. | apache_cxf ; dotnet_wcf ; grpc ; jax_ws |
This is the logical name of the method from the RPC interface perspective, which can be different from the name of any implementing method/function. The code.function
attribute may be used to store the latter (e.g., method executing the call on the server side, RPC client stub method on the client side).
This is the logical name of the service from the RPC interface perspective, which can be different from the name of any implementing class. The code.namespace
attribute may be used to store the latter (despite the attribute name, it may include a class name, e.g., class with method executing actually executing the call on the server side, RPC client stub class on the client side).
rpc.system
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
apache_axis | Apache Axis |
apache_cxf | Apache CXF |
apache_wink | Apache Wink |
aws_api | AWS API |
dotnet_remoting | .NET Remoting |
dotnet_wcf | .NET WCF |
grpc | gRPC |
java_rmi | Java RMI |
jax_ws | JAX-WS |
jboss | JBoss |
jersey | Jersey |
openedge | Progress OpenEdge |
resteasy | JBoss RESTEasy |
restlet | Restlet |
spring_ws | Spring Web Services |
tibco_ws | Tibco Web Services |
weblogic_ws | WebLogic Web Services |
webmethods | Webmethods |
Attribute | Type | Description | Examples |
---|---|---|---|
rpc.grpc.status_code | long | experimental The numeric status code of the gRPC request. |
The server namespace contains information on the responder of a network connection.
Attribute | Type | Description | Examples |
---|---|---|---|
server.address | string | stable Logical server hostname, matches server FQDN if available, and IP or socket address if FQDN is not known. | example.com |
server.port | long | stable Logical server port number. | 65123 ; 80 |
server.resolved_ips | ipAddress[] | stable A list of IP addresses that are the result of DNS resolution of server.address . | [194.232.104.141, 2a01:468:1000:9::140] |
Attribute | Type | Description | Examples |
---|---|---|---|
service.name | string | resource stable The logical name of the service. | shoppingcart |
Attribute | Type | Description | Examples |
---|---|---|---|
servlet.context.name | string | resource experimental also see https://docs.oracle.com/javaee/6/api/javax/servlet/ServletContext.html#getServletContextName | |
servlet.context.path | string | resource experimental also see https://docs.oracle.com/javaee/6/api/javax/servlet/ServletContext.html#getContextPath |
Session properties are custom-defined key-value pairs. Dynatrace RUM captures session properties as part of each of your users' journeys to enrich user sessions.
Attribute | Type | Description | Examples |
---|---|---|---|
session_properties.__property_name__ | record | experimental Contains the value for the session property named __property_name__ defined by the event and session property configuration. The data type of the value depends on the definition; default is data type string . | 42 ; value |
Fields that are used in SNMP extensions.
Attribute | Type | Description | Examples |
---|---|---|---|
trap_oid | string | resource deprecated Used in Extension Framework 2.0 The trap OID of a given event. | SNMPv2-MIB::coldStart |
version | string | resource deprecated Used in Extension Framework 2.0 The SNMP version. | SNMPv3 |
Attribute | Type | Description | Examples |
---|---|---|---|
softwareag.install.root | string | resource experimental | |
softwareag.product.prop.name | string | resource experimental |
Attribute | Type | Description | Examples |
---|---|---|---|
span.alternate_parent_id | uid | experimental The alternative span.id of this span's parent span. If a trace is monitored by more tracing systems (for example, OneAgent and OpenTelemetry), there might be two parent spans. If the two parent spans differ, span.parent_id holds the ID of the parent span originating from same tenant of the span while span.alternate_parent_id holds the other parent span ID. The span.alternate_parent_id is an 8-byte ID and hex-encoded if shown as a string. | f76281848bd8288c |
span.events | record[] | stable A collection of events. An event is an optional time-stamped annotation of the span and consists of a name and key-value pairs. | |
span.exit_by_exception_id | uid | stable The exception.id of the exception the its span.events with the current span exited. The referenced exception has set the attribute exception.escaped to true. | |
span.id | uid | stable A unique identifier for a span within a trace. The span.id is an 8-byte ID and hex-encoded if shown as a string. | f76281848bd8288c |
span.is_exit_by_exception | boolean | stable Set to true if an exception exited the span. If set to false , the span has exception events, but none exited the span. | |
span.is_subroutine | boolean | experimental If set to true , it indicates that this span is a subroutine of its parent span. The spans represent functions running on the same thread on the same call stack. | |
span.kind | string | stable Distinguishes between spans generated in a particular context. | server |
span.links | record[] | stable A collection of links. A link is a reference from this span to a whole trace or a span in the same or different trace. | |
span.name | string | stable The span name identifies the work represented by the span, for example, the route in an HTTP controller, an RPC method name, a function name, or the name of a subtask or stage within a larger computation. | prepareOrderItemsAndShippingQuoteFromCart ; org.example.CheckoutService/PlaceOrder ; orders process ; GET /products/{product_id} ; HTTP POST |
span.parent_id | uid | stable The span.id of this span's parent span. The span.parent_id is an 8-byte ID and hex-encoded if shown as a string. | f76281848bd8288c |
span.status_code | string | stable Defines the status of a span, predominantly used to indicate a processing error. This field is absent if the reported span status is unset . | error |
span.status_message | string | experimental An optional text that can provide a descriptive error message in case the span.status_code is error . | Connection closed before message completed ; Error sending request for url |
span.timing.cpu | duration | stable The overall CPU time spent executing the span, including the CPU times of child spans that are running on the same thread on the same call stack. | |
span.timing.cpu_self | duration | stable The CPU time spent exclusively on executing this span, not including the CPU times of any children. |
span.kind
MUST be one of the following:
Value | Description |
---|---|
client | Indicates that the span describes a request to some remote service. |
consumer | Indicates that a span describes a child of an asynchronous producer request. |
internal | Default Value. Indicates that the span represents an internal operation. |
link | Indicates that the span describes a Dynatrace link node. |
producer | Indicates that the span describes the initiator of an asynchronous request. |
server | Indicates that the span covers server-side handling of a synchronous RPC or other remote request. |
span.status_code
MUST be one of the following:
Value | Description |
---|---|
error | An error happened while processing the span. |
ok | The span was explicitly validated as having completed successfully, despite maybe even containing information about an error. |
Attribute | Type | Description | Examples |
---|---|---|---|
span_event.name | string | stable Some span events have a defined semantics based on the name of the span event. | exception |
span_event.name
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
bizevent | Indicates that the span event represents a business event |
exception | Indicates that the span event represents an exception |
feature_flag | Indicates that the span event represents a feature flag |
Language Independent Interface Types For OpenTelemetry
Attribute | Type | Description | Examples |
---|---|---|---|
spring.application.group | string | resource experimental Also see Common Application Properties | |
spring.application.name | string | resource experimental Also see Common Application Properties | |
spring.profile.name | string | resource experimental The active profile (last value of spring.profiles.active) | |
spring.startup.class | string | resource experimental |
Disk
Attribute | Type | Description | Examples |
---|---|---|---|
storage.disk.encrypted | boolean | resource stable Is encrypted disk. | |
storage.disk.fstype | string | resource stable Type of file system on the disk. | ext4 ; btrfs |
storage.disk.kname | string | resource stable Kernel name of the disk device. It's also the disk ID in relation to other devices. | sda |
storage.disk.model | string | resource stable Disk model. | baracuda |
storage.disk.mountpoint | string | resource stable Primary mount point. | /mnt/disk1 |
storage.disk.other-mountpoints | string[] | resource stable List of other mount points of the disk | [/home/user1/mydisk, /opt/volume1] |
storage.disk.path | string | resource stable Path to the disk. | /dev/sda |
storage.disk.read-only | boolean | resource stable Is read-only disk. | |
storage.disk.removable | boolean | resource stable Is removable disk. | |
storage.disk.serial | string | resource stable Disk serial number. | 1234-56789 |
storage.disk.type | string | resource stable Disk device type. | disk ; hardware raid |
storage.disk.vendor | string | resource stable Vendor of the disk. | seagate |
Partition
Attribute | Type | Description | Examples |
---|---|---|---|
storage.partition.encrypted | boolean | resource stable Is encrypted partition. | |
storage.partition.fstype | string | resource stable Type of file system on the partition. | ext4 ; btrfs |
storage.partition.kname | string | resource stable Kernel name of the partition device. It's also the partition ID in relation to other devices. | sda1 |
storage.partition.mountpoint | string | resource stable Primary mount point. | /mnt/diskA |
storage.partition.other-mountpoints | string[] | resource stable List of other mount points of the partition. | [/home/user1/mydiskA, /opt/volumeA] |
storage.partition.path | string | resource stable Path to the partition. | /dev/sda1 |
storage.partition.read-only | boolean | resource stable Is read-only partition. | |
storage.partition.removable | boolean | resource stable Is removable partition (true when disk is removable). | |
storage.partition.type | string | resource stable Partition device type. | partition |
Volume
Attribute | Type | Description | Examples |
---|---|---|---|
storage.volume.display-name | string | resource stable Name of the volume device. | vg0-lv1 ; vg1-lv2 ; my-volume |
storage.volume.fstype | string | resource stable Type of file system on the volume. | ext4 ; btrfs |
storage.volume.kname | string | resource stable Kernel name of the volume device. It's also the volume ID in relation to other devices. | dm-1 ; dm-2 ; dm-5 |
storage.volume.mountpoint | string | resource stable Primary mount point. | /mnt/diskA |
storage.volume.other-mountpoints | string[] | resource stable List of other mount points of the software RAID. | [/home/user1/mydiskA, /opt/volumeA] |
storage.volume.path | string | resource stable Path to the volume device. | /dev/mapper/vg0-lv1 |
storage.volume.read-only | boolean | resource stable Is read-only volume. | |
storage.volume.removable | boolean | resource stable Is removable volume. | |
storage.volume.type | string | resource stable Volume device type. | lvm |
Software RAID
Attribute | Type | Description | Examples |
---|---|---|---|
storage.software-raid.encrypted | boolean | resource stable Is encrypted software RAID. | |
storage.software-raid.fstype | string | resource stable Type of file system on the software RAID, | ext4 ; btrfs |
storage.software-raid.kname | string | resource stable Kernel name of the software RAID device. It's also the software RAID ID in relation to other devices. | md0 ; md1 ; md3 |
storage.software-raid.mountpoint | string | resource stable Primary mount point. | /mnt/diskA |
storage.software-raid.other-mountpoints | string[] | resource stable List of other mount points of the software RAID. | [/home/user1/mydiskA, /opt/volumeA] |
storage.software-raid.parent | string | resource stable ID of parent software RAID in which this software RAID is nested. | md0 |
storage.software-raid.path | string | resource stable Path to the software RAID device. | /dev/md0 |
storage.software-raid.read-only | boolean | resource stable Is read-only software RAID. | |
storage.software-raid.removable | boolean | resource stable Is removable software RAID. | |
storage.software-raid.type | string | resource stable Software RAID device type. | raid0, raid10 |
Attribute | Type | Description | Examples |
---|---|---|---|
subtrace.id | uid | experimental Present on every span of a subtrace. All spans within one subtrace share the same identifier. The ID is a hex-encoded numerical value and not globally unique, but guaranteed to be unique within one particular trace. | 95efd70fcdb5b7b3 ; 96835e1d65490b48 |
subtrace.is_root_span | boolean | experimental Marks the root of a subtrace. This is typically the first span of a request within a service. Endpoints detection rules are evaluated on subtrace root spans. |
Additional information about the attributes of a data point.
Attribute | Type | Description | Examples |
---|---|---|---|
supportability.alr_sampling_ratio | long | experimental The denominator of the sampling ratio of the Dynatrace cluster, the attribute is only set if Adaptive Load Redution (ALR) is active on the Dynatrace cluster. A numerator is not specified, as it's always 1. If, for example, the Dynatrace cluster samples with a probability of 1/8 (12,5%), the value of supportability.alr_sampling_ratio would be 8 and the numerator is 1. | 8 |
supportability.atm_sampling_ratio | long | experimental The denominator of the sampling ratio of an Adaptive Traffic Management (ATM) aware sampler. The attribute is always present if an ATM-aware sampler is active (this applies, for example, to Dynatrace OneAgent). A numerator is not specified, as it is always 1. If, for example, Dynatrace OneAgent samples with a probability of 1/16 (6,25%), the value of supportability.atm_sampling_ratio would be 16 and the numerator is 1. | 16 |
supportability.custom_service.rule_id | uid | experimental The ID of a custom service configuration rule. This field is only present if a custom service was configured as an automatic instrumentation rule in Dynatrace. | 4d76194c11a9426197a9062548f9e66e |
supportability.dropped_attributes_count | long | experimental The number of attributes that were discarded on the source. Attributes can be discarded because their keys are too long or because there are too many attributes. | 1 |
supportability.dropped_events_count | long | experimental The number of span events that were discarded on the source. | 1 |
supportability.dropped_http_request_headers_count | long | experimental Number of http.request.header.__key__ that were discarded. | 1 |
supportability.dropped_http_request_parameters_count | long | experimental Number of http.request.parameter.__key__ that were discarded. | 1 |
supportability.dropped_links_count | long | experimental The number of span links that were discarded on the source. | 1 |
supportability.flaws | string[] | experimental A string array of one or multiple error codes indicating issues in the assembly of a trace in Dynatrace. Typically, issues come from erroneous (3rd party) instrumentations (e.g. not sending a required field), data loss due to network connectivity (e.g. missing parent span) or conditions implied by the nature of the trace (e.g. trace exceeding the depth limit). The attribute is only present in case an assembly issue was detected (the list will not be empty). For more information and details about specific error codes, please reach out to Dynatrace support. | [C4, S3, A2] |
supportability.latency_before_openpipeline | duration | experimental The difference between the Dynatrace cluster node time and the end_time before the span is forwarded to OpenPipeline. Only available on subtrace root spans sent from the OneAgent. | 500000000000 |
supportability.non_persisted_attribute_keys | string[] | experimental A string array of attribute keys that were not stored as they were not allow-listed or were removed during the pipeline steps. | ["my_span_attribute", "db.name"] |
supportability.original_start_time | timestamp | experimental The original start time of the span. Only available if the value of the start_time attribute was truncated. Truncating the start time is technically required for long running spans that have a start time older than three days in the past. | 1649822520123123123 |
supportability.serverid.addressee | long | experimental The id of the Dynatrace cluster node this span was addressed to. This is only available if it differs from the value of supportability.serverid.processing . | 5 |
supportability.serverid.processing | long | experimental The id of the Dynatrace cluster node that received and processed this span. | 5 |
Span sensor rules used during ingestion of OpenTelemetry/OpenTracing spans by instrumentation of the OpenTelemetry/OpenTracing Apis are applied at span start time. Therefore these rules can only operate on span attributes given at span start time.
The value at span start time of attributes captured by this instrumentation is preserved to allow proper rule configuration.
Attribute | Type | Description | Examples |
---|---|---|---|
supportability.span_start.__key__ | record | experimental Span attributes set at span start time in case it changed later. The value at span start is relevant for span rule evaluation done by OpenTelemetry/OpenTracing instrumentation. __key__ is a placeholder for the actual attribute name. The data type of the value depends on the attribute. | 5, "initial", ["a", "b"] |
supportability.span_start.attribute_names | array | experimental List of attribute names set at span start invocation time. | |
supportability.span_start.span.name | string | experimental The span name at span start time in case it changed later. The value at span start is relevant for span rule evaluation done by OpenTelemetry/OpenTracing instrumentation. | GET |
The telemetry.sdk.*
fields are used to describe the telemetry SDK in OpenTelemetry or ODIN ingest. It can be considered the closest equivalent of ODIN/OTel data to dt.agent.module.*
.
The telemetry.exporter.*
fields are used to define the exporter that exports telemetry data and is expected to be different for each exporter in case when multiple exporters co-exist.
Attribute | Type | Description | Examples |
---|---|---|---|
telemetry.exporter.name | string | resource experimental The exporter name. | odin |
telemetry.exporter.package_version | string | resource experimental The version as exposed to the package manager (for example, npm). | 1.285.1 |
telemetry.exporter.version | string | resource experimental The full agent/exporter version. | 1.285.1.20240101-256988 |
telemetry.sdk.language | string | resource stable The programming language/tech of the telemetry SDK. | nodejs ; python ; java |
telemetry.sdk.name | string | resource stable The name of the telemetry SDK. | odin ; opentelemetry |
telemetry.sdk.version | string | resource stable The version string of the telemetry SDK. | 1.20.0 |
Attribute | Type | Description | Examples |
---|---|---|---|
thread.id | long | stable Current "managed" thread id (as opposed to OS thread id). | 42 |
thread.name | string | stable Current thread name. | main |
thread.pool.name | string | stable The name of the thread pool. | WorkerThreadPool |
Attribute | Type | Description | Examples |
---|---|---|---|
tibco.businessworks.app.node.name | string | resource experimental | |
tibco.businessworks.app.space.name | string | resource experimental | |
tibco.businessworks.domain.name | string | resource experimental | |
tibco.businessworks.home | string | resource experimental | |
tibco.businessworks.property.file.name | string | resource experimental | |
tibco.businessworks.property.file.path | string | resource experimental | |
tibco.businessworks_ce.app.name | string | resource experimental | |
tibco.businessworks_ce.version | string | resource experimental |
The time_correction namespace contains information on time corrections applied to the timestamps of an event, for example, start_time
, timestamp
or event.end
.
Time corrections may be necessary if events are reported with timestamps that are completely off compared to cluster time. For example, Dynatrace RUM reported data can be off depending on client time.
Attribute | Type | Description | Examples |
---|---|---|---|
time_correction.is_applied | boolean | experimental If set to true , time correction has been applied to the event's timestamps. | false |
time_correction.offset | long | experimental The offset (in nanoseconds) that is applied to all timestamp fields. The value may be negative. | 127927969312 |
Attribute | Type | Description | Examples |
---|---|---|---|
tls.cipher | string | experimental String indicating the cipher used during the current connection. | TLS_RSA_WITH_3DES_EDE_CBC_SHA ; TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 |
tls.protocol.name | string | experimental Normalized lowercase protocol name parsed from the original string of the negotiated SSL/TLS protocol version. | ssl ; tls |
tls.protocol.version | string | experimental The numeric part of the version parsed from the original string of the negotiated SSL/TLS protocol version. | 1.2 ; 3 |
Attribute | Type | Description | Examples |
---|---|---|---|
trace.alternate_id | uid | experimental The preserved trace ID when OneAgent and other tracing systems monitor the same process and the trace ID from the other tracing system was replaced by the OneAgent trace ID. The trace.alternate_id is a 16-byte ID and hex-encoded if shown as a string. | 357bf70f3c617cb34584b31bd4616af8 |
trace.capture.reasons | string[] | experimental Explains why this trace was captured, multiple reasons can apply simultaneously. Note: 'atm' and 'fixed' are mutually exclusive sampling approaches, though 'fixed' may appear with other capture triggers. Values: 'atm' (Dynatrace's intelligent sampling automatically adjusted trace capture based on traffic volume and system load), 'fixed' (trace captured due to configured percentage rules - either global settings or specific endpoint rules), 'custom' (trace captured because of custom correlation headers propagated between services or systems), 'mainframe' (trace originated from or includes IBM mainframe/z/OS components), 'serverless' (trace captured from serverless functions like AWS Lambda, Azure Functions, or similar platforms), 'rum' (trace initiated by user interactions in web browsers or mobile apps monitored by Dynatrace RUM agents). | [['atm'], ['fixed'], ['fixed', 'custom'], ['fixed', 'rum']] |
trace.id | uid | stable A unique identifier for a trace. The trace.id is a 16-byte ID and hex-encoded if shown as a string. | 357bf70f3c617cb34584b31bd4616af8 |
trace.is_sampled | boolean | experimental Flag indicating whether the trace was sampled out. If set to true , the trace is recorded. If set to false , the trace is ignored. | true ; false |
trace.state | string | experimental The trace state in the w3c-trace-context format. | f4fe05b2-bd92206c@dt=fw4;3;abf102d9;c4592;0;0;0;2ee;5607;2h01;3habf102d9;4h0c4592;5h01;6h5f9a543f1184a52b1b744e383038911c;7h6564df6f55bd6eae,apmvendor=boo,foo=bar |
The url namespace contains semantic conventions for URL and its components.
Attribute | Type | Description | Examples |
---|---|---|---|
url.domain | string | experimental The URI domain component. | www.foo.bar ; google.com ; wikipedia.org |
url.fragment | string | stable The URI fragment component. | SemConv |
url.full | string | stable Absolute URL describing a network resource according to RFC3986. Tags: sensitive-spans | https://www.foo.bar/docs/search?q=OpenTelemetry#SemConv |
url.path | string | stable The URI path component. | /docs/search |
url.port | long | experimental The URI port component. | 443 ; 80 |
url.provider | string | experimental The provider type for the host name of url.full . This information is determined by Dynatrace RUM resource detection. | third_party |
url.query | string | stable The URI query component. Tags: sensitive-spans | q=OpenTelemetry |
url.scheme | string | stable The URI scheme component identifying the used protocol. | https ; ftp ; telnet |
url.truncated_path | string | experimental Truncated URI path component for endpoint detection of certain technologies that do not provide a http.route . The truncation logic depends on the technology and is a best effort to provide a stable value. Example Adobe Experience Manager (AEM): First two parts of url.path . Truncated value of /content/wknd/us/en/ is /content/wknd . | /docs |
url.provider
MUST be one of the following:
Value | Description |
---|---|
cdn | CDN (content delivery network). |
first_party | First-party provider. |
third_party | Third-party provider. |
Representation of a physical or logical user.
Attribute | Type | Description | Examples |
---|---|---|---|
user.email | string | stable Email of the user. | user@mail.com |
user.id | string | stable Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used. | 35ba9499-f87c-4047-962c-14dc32e255e5 ; system |
user.name | string | experimental Full name of the user. If the system itself has to be represented, the constant 'System' is used. | Wolfgang Amadeus Mozart ; System |
user.organization | string | experimental Organization the user belongs to. | DYNATRACE ; CUSTOMER ; PARTNER |
user.organization
MUST be one of the following:
Value | Description |
---|---|
CUSTOMER | Customer organization |
DYNATRACE | Dynatrace organization |
PARTNER | Dynatrace partner organization |
user.organization
MUST be one of the following:
Value | Description |
---|---|
DYNATRACE | Dynatrace organization |
CUSTOMER | Customer organization |
PARTNER | Dynatrace partner organization |
The vcs
namespace contains information about Version Control Systems.
Attribute | Type | Description | Examples |
---|---|---|---|
vcs.change.id | string | experimental The identifier of the change, for example, pull request ID or merge request ID. It is typically unique per repository and generated by the version control system itself. | 1234 |
vcs.change.state | string | experimental The state of the change, for example, the state of a pull request or merge request. | wip ; open ; reopened ; closed ; merged |
vcs.change.title | string | experimental The human-readable title of the change, for example, pull request title or merge request title. | CA-1234: Fix some stuff ; [chore] update dependency |
vcs.change.url.full | string | experimental The full URL to the change, for example, the full URL to the pull request or merge request. | https://github.com/dynatrace-oss/terraform-provider-dynatrace/pull/20 |
vcs.line_change.type | string | experimental The type of line change being measured on a branch or change. | added ; removed |
vcs.ref.base.name | string | experimental The name of the reference in the repository. This can be a branch name or a tag name. 1 | my-branch-name |
vcs.ref.base.revision | string | experimental The revision in the repository. For Git this is a synonym for a commit hash, whereas in SVN it is a revision number. 2 | d4322ab6cba38d21ad83c9de304a6a214ecf2cdc ; main ; 1337 |
vcs.ref.base.type | string | experimental The reference type in the repository. 3 | branch ; tag |
vcs.ref.head.name | string | experimental The name of the reference in the repository. This can be a branch name or a tag name. 4 | my-branch-name |
vcs.ref.head.revision | string | experimental The revision in the repository. For Git, this is a synonym for a commit hash, whereas in SVN, it is a revision number. 5 | d4322ab6cba38d21ad83c9de304a6a214ecf2cdc ; main ; 1337 |
vcs.ref.head.type | string | experimental The reference type in the repository. 6 | branch ; tag |
vcs.ref.type | string | experimental The reference type in the repository. | branch ; tag |
vcs.repository.name | string | experimental The human-readable name of the repository. It should not include any additional identifiers like GitLab group or GitHub organization. 7 | dynatrace-configuration-as-code |
vcs.repository.url.full | string | experimental The repository's full URL. 8 | https://github.com/dynatrace-oss/terraform-provider-dynatrace |
vcs.revision_delta.direction | string | experimental The type of revision comparison. | ahead ; behind |
The base name refers to the starting point of a change. For example, if a feature branch was created from main
,
main
is the base reference of type branch
.
The base revision refers to the starting revision of a change. For example, if a branch was created from a certain commit, this commit is the base revision.
The base type refers to the reference type of the starting point of a change. For example,
if a feature branch was created from the main
branch, branch
is the base reference's type.
The head name refers to the current reference's name. For example,
if main
is currently checked out, the head name is main
.
The head revision refers to the currently referenced revision.
The head type refers to the currently referenced type in the repository. For example,
if the main
branch is currently checked out, the head reference is of type branch
.
Be aware that the repository name might clash with forked repositories.
For Git VCS, this should not include the .git
URL suffix.
vcs.change.state
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
closed | The change was closed without being merged into the target code base. |
merged | The change has successfully been merged into the target code base. |
open | The change is open and ready for review or currently under review. It has not been merged yet, and changes are still possible. |
reopened | The change was re-opened after being closed and is ready for review again. |
wip | The change is still a work in progress and not yet ready for review. |
vcs.line_change.type
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
added | How many lines were added. |
removed | How many lines were removed. |
vcs.ref.base.type
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
branch | The base reference type is a branch. |
tag | The base reference type is a tag. |
vcs.ref.head.type
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
branch | The head reference type is a branch. |
tag | The head reference type is a tag. |
vcs.ref.type
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
branch | The reference type is a branch. |
tag | The reference type is a tag. |
vcs.revision_delta.direction
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
ahead | How many revisions the change is ahead of the target ref. |
behind | How many revisions the change is behind of the target ref. |
The view namespace contains information on the view of a user event.
Attribute | Type | Description | Examples |
---|---|---|---|
view.background_time | duration | experimental Aggregated time that the view was in the background. | 0 |
view.detected_name | string | experimental The name RUM JavaScript detected for the view. The value is based on view.url.full . Not applicable for OneAgent for Mobile. | #dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e |
view.foreground_time | duration | experimental Aggregated time that the view was in the foreground. | 900000000 |
view.id | uid | experimental A random ID that is generated every time a user navigates to a new view. The view.id is an 8-byte ID and hex-encoded if shown as a string. | f76281848bd8288c |
view.name | string | experimental An identifier for grouping views. The value can be reported via the Dynatrace API. If not reported via the Dynatrace API, the value is automatically calculated from view.detected_name for user events reported by RUM JavaScript. | #dashboard;id=<uuid> ; LoginActivity |
view.prerender_time | duration | experimental Aggregated time that the view was prerendering. | 0 |
view.sequence_number | long | experimental The number of views throughout the page's entire lifespan. | 1 |
view.source.detected_name | string | experimental The view.detected_name value of the previous view. Not applicable for OneAgent for Mobile. | #dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e |
view.source.id | uid | experimental The ID of the previous view. Not supported by OneAgent for Mobile. | f76281848bd8288c |
view.source.name | string | experimental The view.name value of the previous view. Not supported by OneAgent for Mobile. | #dashboard;id=<uuid> |
view.source.url.domain | string | experimental The URI host component of the source view URL. This is extracted from view.source.url.full . | www.foo.bar |
view.source.url.fragment | string | experimental The URI fragment component of the source view URL. This is extracted from view.source.url.full . | #dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
view.source.url.full | string | experimental The location.href of the previous view. This is the full URL provided in the format scheme://host[:port]/path[?query][#fragment] . Not applicable for OneAgent for Mobile. | https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
view.source.url.path | string | experimental The URI path component of the source view URL. This is extracted from view.source.url.full . | /path |
view.source.url.query | string | experimental The URI query component of the source view URL. This is extracted from view.source.url.full . | q=value |
view.source.url.scheme | string | experimental The URI scheme component of the source view URL. This is extracted from view.source.url.full . | https ; http |
view.url.domain | string | experimental The URI host component of the view URL. This is extracted from view.url.full . | www.foo.bar |
view.url.fragment | string | experimental The URI fragment component of the view URL. This is extracted from view.url.full . | dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
view.url.full | string | experimental The location.href at the time of the event. This is the full URL provided in the format scheme://host[:port]/path[?query][#fragment] . Not applicable for OneAgent for Mobile. | https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
view.url.path | string | experimental The URI path component of the view URL. This is extracted from view.url.full . | /path |
view.url.query | string | experimental The URI query component of the view URL. This is extracted from view.url.full . | q=value |
view.url.scheme | string | experimental The URI scheme component of the view URL. This is extracted from view.url.full . | https ; http |
Fields that can come from applications running on VMware.
Attribute | Type | Description | Examples |
---|---|---|---|
vmware.datacenter.name | string | resource experimental The name of the data center in which the hypervisor is running. | srvwasapp1Cell01 |
vmware.disk.name | string | resource experimental ESXi host disk. | srvwasapp1Cell01 |
vmware.hypervisor.name | string | resource experimental ESXi host. | my-hypervisor.lab.dynatrace.org |
vmware.nic.name | string | resource experimental ESXi host network interface. | vmnic0 ; vmnic1 ; vmnic2 |
vmware.vcenter.name | string | resource experimental Name of the VMware vCenter server managing the multi-hypervisor environment. | my-vcenter.lab.dynatrace.org |
vmware.vm.name | string | resource experimental The name of the virtual machine. | easytravel-demo |
Attribute | Type | Description | Examples |
---|---|---|---|
vulnerability.code_location.name | string | stable Name of the code location where the code-level vulnerability was detected. | org.dynatrace.profileservice.BioController.markdownToHtml(String):80 |
vulnerability.cvss.base_score | double | stable Vulnerability's CVSS base score provided by NVD. | 8.1 |
vulnerability.cvss.version | string | stable Vulnerability's CVSS score version. | 3.1 ; 4.0 |
vulnerability.davis_assessment.assessment_mode | string | stable Availability of the information based on which the vulnerability assessment has been done. | FULL ; NOT_AVAILABLE ; REDUCED |
vulnerability.davis_assessment.assessment_mode_reasons | string[] | experimental Reasons for the assessment mode. | [LIMITED_BY_CONFIGURATION, LIMITED_AGENT_SUPPORT] |
vulnerability.davis_assessment.data_assets_status | string | stable Vulnerability's reachability of related data assets by affected entities. | NOT_AVAILABLE ; NOT_DETECTED ; REACHABLE |
vulnerability.davis_assessment.exploit_status | string | stable Vulnerability's public exploits status. | AVAILABLE ; NOT_AVAILABLE |
vulnerability.davis_assessment.exposure_status | string | stable Vulnerability's internet exposure status. | NOT_AVAILABLE ; NOT_DETECTED ; PUBLIC_NETWORK ; ADJACENT_NETWORK |
vulnerability.davis_assessment.level | string | stable Vulnerability's risk level based on Davis Security Score. | LOW ; MEDIUM ; HIGH ; CRITICAL ; NONE |
vulnerability.davis_assessment.score | double | stable Vulnerability's Davis Security Score (1-10) calculated by Dynatrace. | 8.1 |
vulnerability.davis_assessment.vulnerable_function_status | string | stable Usage status of the vulnerable functions causing the vulnerability. | IN_USE ; NOT_AVAILABLE ; NOT_IN_USE |
vulnerability.description | string | stable Description of the vulnerability. | More detailed description about improper input validation vulnerability. |
vulnerability.display_id | string | stable Dynatrace user-readable identifier for the vulnerability. | S-1234 |
vulnerability.exploit.status | string | experimental Whether there is a known exploit for the vulnerability. | AVAILABLE ; NOT_AVAILABLE |
vulnerability.external_id | string | stable External provider's unique identifier for the vulnerability. | SNYK-JAVA-ORGAPACHEHTTPCOMPONENTS-30646 |
vulnerability.external_url | string | stable External provider's URL to the details page of the vulnerability. | https://example.com |
vulnerability.first_seen | timestamp | stable Timestamp of when the vulnerability was first detected. | 2023-03-22T13:19:36.945Z |
vulnerability.id | string | stable Dynatrace unique identifier for the vulnerability. | 2039861408676243188 |
vulnerability.is_fix_available | boolean | experimental Indicates if a vulnerability fix is available. | |
vulnerability.mute.change_date | timestamp | stable Timestamp of the vulnerability's last muted or unmuted action. | 2023-03-22T13:19:36.945Z |
vulnerability.mute.comment | string | experimental Comment when muting or unmuting the vulnerability. | Muted because it's a false positive. |
vulnerability.mute.reason | string | stable Reason for muting or unmuting the vulnerability. | FALSE_POSITIVE ; IGNORE ; AFFECTED ; CONFIGURATION_NOT_AFFECTED ; OTHER |
vulnerability.mute.status | string | stable Vulnerability's mute status. | MUTED ; NOT_MUTED |
vulnerability.mute.user | string | stable User who last changed the vulnerability's mute status. | user@example.com |
vulnerability.parent.davis_assessment.assessment_mode | string | stable Availability of the information based on which the vulnerability assessment has been done. | FULL ; NOT_AVAILABLE ; REDUCED |
vulnerability.parent.davis_assessment.data_assets_status | string | stable Vulnerability's reachability of related data assets by affected entities. | NOT_AVAILABLE ; NOT_DETECTED ; REACHABLE |
vulnerability.parent.davis_assessment.exposure_status | string | stable Vulnerability's internet exposure status. | NOT_AVAILABLE ; NOT_DETECTED ; PUBLIC_NETWORK ; ADJACENT_NETWORK |
vulnerability.parent.davis_assessment.level | string | stable Vulnerability's Davis Security Score level. | LOW ; MEDIUM ; HIGH ; CRITICAL ; NONE |
vulnerability.parent.davis_assessment.score | double | stable Vulnerability's Davis Security Score (1-10) calculated by Dynatrace. | 8.1 |
vulnerability.parent.davis_assessment.vulnerable_function_status | string | stable Usage status of vulnerable functions causing the vulnerability. Status is IN_USE when there's at least one vulnerable function in use by an application. | IN_USE ; NOT_AVAILABLE ; NOT_IN_USE |
vulnerability.parent.first_seen | string | stable Timestamp of when the vulnerability was first detected. | 2023-03-22T13:19:36.945Z |
vulnerability.parent.mute.change_date | timestamp | stable Timestamp of the last mute or unmute action of the vulnerability. | 2023-03-22T13:19:36.945Z |
vulnerability.parent.mute.reason | string | stable Reason for muting or unmuting the vulnerability. | FALSE_POSITIVE ; IGNORE ; AFFECTED ; CONFIGURATION_NOT_AFFECTED ; OTHER |
vulnerability.parent.mute.status | string | stable Vulnerability's mute status. | MUTED ; NOT_MUTED |
vulnerability.parent.mute.user | string | stable User who last changed the vulnerability's mute status. | user@example.com |
vulnerability.parent.resolution.change_date | string | stable Timestamp of the vulnerability's last resolution status change. | 2023-03-22T13:19:37.466Z |
vulnerability.parent.resolution.status | string | stable Current status of the vulnerability. | OPEN ; RESOLVED |
vulnerability.parent.risk.level | string | stable Vulnerability's risk score level defined by the provider. For Dynatrace, the Davis Security Score level. | LOW ; MEDIUM ; HIGH ; CRITICAL ; NONE |
vulnerability.parent.risk.score | double | stable Vulnerability's risk score defined by the provider. For Dynatrace, Davis Security Score. | 8.1 |
vulnerability.previous.cvss.base_score | double | stable Vulnerability's previous CVSS base score (in case the CVSS base score has changed). | 8.1 |
vulnerability.previous.davis_assessment.data_assets_status | string | stable Vulnerability's previous reachability of related data assets by affected entities (in case the reachability has changed). | NOT_AVAILABLE ; NOT_DETECTED ; REACHABLE |
vulnerability.previous.davis_assessment.exploit_status | string | stable Vulnerability's previous public exploit status (in case the public exploit status has changed). | AVAILABLE ; NOT_AVAILABLE |
vulnerability.previous.davis_assessment.exposure_status | string | stable Vulnerability's previous internet exposure status (in case the internet exposure status has changed). | NOT_AVAILABLE ; NOT_DETECTED ; PUBLIC_NETWORK ; ADJACENT_NETWORK |
vulnerability.previous.davis_assessment.level | string | stable Vulnerability's previous risk level (in case the risk level has changed). | LOW ; MEDIUM ; HIGH ; CRITICAL ; NONE |
vulnerability.previous.davis_assessment.score | double | stable Vulnerability's previous Davis Security Score (in case Davis Security Score has changed). | 8.1 |
vulnerability.previous.davis_assessment.vulnerable_function_status | string | stable Vulnerability's previous vulnerable function status (in case the vulnerable function status has changed). | IN_USE ; NOT_AVAILABLE ; NOT_IN_USE |
vulnerability.previous.mute.change_date | string | stable Timestamp of the vulnerability's previous mute status (in case the mute status has changed). | 2023-03-22T13:19:36.945Z |
vulnerability.previous.mute.comment | string | experimental Comment of the vulnerability's previous mute status. | Muted because it's a false positive. |
vulnerability.previous.mute.reason | string | stable Reason for last muting or unmuting the vulnerability (in case the reason for muting or unmuting the vulnerability has changed). | Muted: False positive |
vulnerability.previous.mute.status | string | stable Vulnerability's previous mute status (in case the mute status has changed). | MUTED ; NOT_MUTED |
vulnerability.previous.mute.user | string | stable User who last changed the vulnerability's mute status (in case the mute status was last changed by a different user). | user@example.com |
vulnerability.previous.resolution.status | string | stable Vulnerability's previous resolution status (in case the resolution status has changed). | OPEN ; RESOLVED |
vulnerability.previous.risk.level | string | stable Vulnerability's previous risk score level (in case the risk score level has changed). | LOW ; MEDIUM ; HIGH ; CRITICAL |
vulnerability.previous.risk.score | double | stable Vulnerability's previous risk score (in case the risk score has changed). | 8.1 |
vulnerability.references.cve | string[] | stable List of the vulnerability's CVE IDs. | [CVE-2021-41079] |
vulnerability.references.cwe | string[] | stable List of the vulnerability's CWE IDs. | [CWE-20] |
vulnerability.references.owasp | string[] | stable List of vulnerability's OWASP IDs. | [2021:A3] |
vulnerability.remediation.description | string | experimental Description of the vulnerability's remediation advice. | Upgrade component to version 1.2.3 or higher |
vulnerability.remediation.status | string | experimental Indicates whether a fix for the vulnerability is available. | AVAILABLE ; NOT_AVAILABLE |
vulnerability.resolution.change_date | timestamp | stable Timestamp of the vulnerability's last resolution status change. | 2023-03-22T13:19:37.466Z |
vulnerability.resolution.status | string | stable Vulnerability's resolution status. | OPEN ; RESOLVED |
vulnerability.risk.level | string | stable Vulnerability's risk score level defined by the provider. For Dynatrace, the Davis Security Score level. | LOW ; MEDIUM ; HIGH ; CRITICAL ; NONE |
vulnerability.risk.scale | string | stable Scale by which the vulnerability's risk score and risk score level defined by the provider are measured. | Davis Security Score |
vulnerability.risk.score | double | stable Vulnerability's risk score defined by the provider. For Dynatrace, Davis Security Score. | 8.1 |
vulnerability.stack | string | experimental Level of the vulnerable component in the technological stack. | CODE ; CODE_LIBRARY ; SOFTWARE ; CONTAINER_ORCHESTRATION |
vulnerability.technology | string | stable Technology of the vulnerable component. | JAVA ; DOTNET ; GO ; PHP ; NODE_JS |
vulnerability.title | string | stable Title of the vulnerability. | Improper Input Validation |
vulnerability.type | string | stable Classification of the vulnerability based on commonly accepted enums, such as CWE. | Improper Input Validation |
vulnerability.url | string | stable Dynatrace URL to the details page of the vulnerability. | | https://example.com |
vulnerability.davis_assessment.assessment_mode
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
FULL | full |
NOT_AVAILABLE | not_available |
REDUCED | reduced |
vulnerability.davis_assessment.data_assets_status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
NOT_AVAILABLE | not_available |
NOT_DETECTED | not_detected |
REACHABLE | reachable |
vulnerability.davis_assessment.exploit_status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
AVAILABLE | available |
NOT_AVAILABLE | not_available |
vulnerability.davis_assessment.exposure_status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
ADJACENT_NETWORK | adjacent_network |
NOT_AVAILABLE | not_available |
NOT_DETECTED | not_detected |
PUBLIC_NETWORK | public_network |
vulnerability.davis_assessment.level
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
CRITICAL | critical |
HIGH | high |
LOW | low |
MEDIUM | medium |
NONE | none |
vulnerability.davis_assessment.vulnerable_function_status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
IN_USE | in_use |
NOT_AVAILABLE | not_available |
NOT_IN_USE | not_in_use |
vulnerability.mute.reason
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
AFFECTED | affected |
CONFIGURATION_NOT_AFFECTED | configuration_not_affected |
FALSE_POSITIVE | false_positive |
IGNORE | ignore |
OTHER | other |
vulnerability.mute.status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
MUTED | muted |
NOT_MUTED | not_muted |
vulnerability.parent.davis_assessment.assessment_mode
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
FULL | full |
NOT_AVAILABLE | not_available |
REDUCED | reduced |
vulnerability.parent.davis_assessment.data_assets_status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
NOT_AVAILABLE | not_available |
NOT_DETECTED | not_detected |
REACHABLE | reachable |
vulnerability.parent.davis_assessment.exposure_status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
ADJACENT_NETWORK | adjacent_network |
NOT_AVAILABLE | not_available |
NOT_DETECTED | not_detected |
PUBLIC_NETWORK | public_network |
vulnerability.parent.davis_assessment.level
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
CRITICAL | critical |
HIGH | high |
LOW | low |
MEDIUM | medium |
NONE | none |
vulnerability.parent.davis_assessment.vulnerable_function_status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
IN_USE | in_use |
NOT_AVAILABLE | not_available |
NOT_IN_USE | not_in_use |
vulnerability.parent.mute.reason
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
AFFECTED | affected |
CONFIGURATION_NOT_AFFECTED | configuration_not_affected |
FALSE_POSITIVE | false_positive |
IGNORE | ignore |
OTHER | other |
vulnerability.parent.mute.status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
MUTED | muted |
NOT_MUTED | not_muted |
vulnerability.parent.resolution.status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
OPEN | open |
RESOLVED | resolved |
vulnerability.parent.risk.level
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
CRITICAL | critical |
HIGH | high |
LOW | low |
MEDIUM | medium |
NONE | none |
vulnerability.previous.davis_assessment.data_assets_status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
NOT_AVAILABLE | not_available |
NOT_DETECTED | not_detected |
REACHABLE | reachable |
vulnerability.previous.davis_assessment.exploit_status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
AVAILABLE | available |
NOT_AVAILABLE | not_available |
vulnerability.previous.davis_assessment.exposure_status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
ADJACENT_NETWORK | adjacent_network |
NOT_AVAILABLE | not_available |
NOT_DETECTED | not_detected |
PUBLIC_NETWORK | public_network |
vulnerability.previous.davis_assessment.level
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
CRITICAL | critical |
HIGH | high |
LOW | low |
MEDIUM | medium |
NONE | none |
vulnerability.previous.davis_assessment.vulnerable_function_status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
IN_USE | in_use |
NOT_AVAILABLE | not_available |
NOT_IN_USE | not_in_use |
vulnerability.previous.mute.status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
MUTED | muted |
NOT_MUTED | not_muted |
vulnerability.previous.resolution.status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
OPEN | open |
RESOLVED | resolved |
vulnerability.previous.risk.level
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
CRITICAL | critical |
HIGH | high |
LOW | low |
MEDIUM | medium |
NONE | none |
vulnerability.resolution.status
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
OPEN | open |
RESOLVED | resolved |
vulnerability.risk.level
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
CRITICAL | critical |
HIGH | high |
LOW | low |
MEDIUM | medium |
NONE | none |
vulnerability.stack
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
CODE | code |
CODE_LIBRARY | code_library |
CONTAINER_ORCHESTRATION | container_orchestration |
SOFTWARE | software |
vulnerability.technology
has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
Value | Description |
---|---|
DOTNET | dotnet |
GO | go |
JAVA | java |
NODE_JS | node_js |
PHP | php |
The web vitals namespace contains the web vitals attributes captured by Dynatrace RUM.
Attribute | Type | Description | Examples |
---|---|---|---|
web_vitals.cumulative_layout_shift | double | experimental The Cumulative Layout Shift (CLS) value. | 0.1279 |
web_vitals.first_contentful_paint | duration | experimental The First Contentful Paint (FCP) value. | 92000000 |
web_vitals.first_input | duration | experimental The First Input value. | 6000000 |
web_vitals.first_input_delay | duration | experimental The First Input Delay (FID) value. | 6000000 |
web_vitals.first_paint | duration | experimental The First Paint value. | 92451200 |
web_vitals.interaction_to_next_paint | duration | experimental The Interaction to Next Paint (INP) value. | 190000000 |
web_vitals.largest_contentful_paint | duration | experimental The Largest Contentful Paint (LCP) value. | 880000000 |
web_vitals.time_to_first_byte | duration | experimental The Time to First Byte value. | 92000000 |
Attribute | Type | Description | Examples |
---|---|---|---|
weblogic.cluster.name | string | resource experimental The name of the cluster this instance belongs to. | OrderManagement2 |
weblogic.domain.name | string | resource experimental The name of the domain this instance belongs to. | CustomerManagementFulfillmentSvc |
weblogic.home | string | resource experimental The instance's home directory. | /apps/infra/wls/bin/10.3.6_64/wlserver_10.3/server |
weblogic.server.name | string | resource experimental The instance's server name. | OrderManagement2Srv1 |
Attribute | Type | Description | Examples |
---|---|---|---|
websphere.cell.name | string | resource experimental The name of the cell this instance belongs to. | srvwasapp1Cell01 |
websphere.cluster.name | string | resource experimental The name of the cluster this instance belongs to. | CluApp1 |
websphere.node.name | string | resource experimental Name of the node to which this instance belongs. | nodeSrvApp2 |
websphere.server.name | string | resource experimental The instance's server name. | SrvApp2 |
Attribute | Type | Description | Examples |
---|---|---|---|
websphere_liberty.server.name | string | resource experimental The instance's server name. | defaultServer |
Attribute | Type | Description | Examples |
---|---|---|---|
winlog.eventid | long | experimental Event ID is a unique identifier assigned to each event logged by the system. Each event ID corresponds to a specific type of event, such as an error, warning, or informational message. (4624 -> successful logon, 1000 -> application error) | 4624 ; 1000 |
winlog.keywords | string | experimental Keywords are used to categorize and group events. This categorization allows to quickly identify and focus on specific types of events that are relevant to your troubleshooting or monitoring needs. | Classic ; Started |
winlog.level | string | experimental Level of an event indicates its severity or importance | Critical ; Error ; Warrning |
winlog.opcode | string | experimental Opcode is a value that identifies a specific activity or a point within an activity that the application was performing when it raised the event. This helps in understanding the context of the event more precisely. | Info ; Download |
winlog.provider | string | experimental Provider is a component or service that generates events. Providers are responsible for writing specific types of events to the event logs, such as application errors, security events, or system warnings. | Avecto Service ; Security-SPP |
winlog.task | long | experimental Task refers to the specific operation or activity that an event is associated with. Each event is categorized under a task, which helps in identifying what the system or application was doing when the event was logged. This can be particularly useful for troubleshooting and understanding the context of the event. (5 -> HTTP Configuration Property Trace Task, 12804 -> Other Object Access Events) | 5 ; 12804 |
winlog.username | string | experimental Username refers to the account name associated with specific events, such as logon or logoff activities. This is particularly useful for tracking user activity and identifying who was logged into the system at a given time. | SYSTEM ; N/A |
Attribute | Type | Description | Examples |
---|---|---|---|
cics.transaction.system_id | string | resource experimental The system ID of the CICS region that this transaction executed on. | C259 ; CICS |
zos.address_space_id | long | resource experimental The address space identifier (ASID) of the z/OS address space. | 1 ; 296 |
zos.job_id | string | resource experimental The job ID of the z/OS address space. | JOB12345 |
zos.job_name | string | resource experimental The jobname of the z/OS address space. | CICSAOR0 ; CTGATM00 ; IMSCR15 |
zos.job_step_id | string | resource experimental The step ID within the job within the z/OS address space. | 00000001 ; 00000002 |
zos.lpar_name | string | resource experimental The name of the LPAR that the z/OS address space executes within. | S0W1 ; ABCD |
zos.sys_id | string | resource experimental The system ID of the CICS/IMS address space. | C259 ; CICS ; IMSF |
zos.transaction.job_name | string | resource experimental The jobname of the z/OS address space that the transaction executed in. | CICSAOR0 ; CTGATM00 ; IMSCR15 |
zos.transaction.lpar_name | string | resource experimental The name of the LPAR that the transaction executed on. | S0W1 ; ABCD |
Attribute | Type | Description | Examples |
---|---|---|---|
zos.transaction.call_type | string | experimental The type of transaction call that was invoked. | CTG |
zos.transaction.id | string | experimental The ID of this transaction. | CEMT ; DTAX ; IVTNO |
zos.transaction.program_type | string | experimental The type of transaction that was executed. | DLI_DB ; DLI_DC ; MQ ; DB2 |
zos.transaction.call_type
MUST be one of the following:
Value | Description |
---|---|
CTG | A CTG request triggered this transaction. |
DPL | A CICS DPL request triggered this transaction. |
HTTP | An HTTP or HTTPS request triggered this transaction. |
IMS_CONNECT | An IMS Connect request triggered this transaction. |
IMS_CONNECT_API | An IMS Connect API request triggered this transaction. |
IMS_TRANS_EXEC | The application program being scheduled and running to handle this transaction. |
ITRA | An IMS TM Resource Adapter request triggered this transaction. |
MQ | An MQ operation triggered this transaction. |
MSC | An IMS MSC request triggered this transaction. |
PGM_SWITCH | An IMS Program Switch request triggered this transaction. |
SDK | An SDK call triggered this transaction. |
SHARED_QUEUE | An IMS Shared Queue request triggered this transaction. |
SOAP | A SOAP request triggered this transaction. |
START | An EXEC CICS START triggered this transaction. |
TTX | A green screen terminal transaction code triggered this transaction. |
TX | A CICS or IMS transaction code triggered this transaction. |
ZOS_CONNECT | A z/OS Connect request triggered this transaction. |
zos.transaction.program_type
MUST be one of the following:
Value | Description |
---|---|
DB2 | The transaction performs DB2 database actions. |
DLI_DB | The transaction performs DLI database actions. |
DLI_DC | The transaction performs DLI data communications actions. |
MQ | The transaction performs MQ Queue actions. |
Attribute | Type | Description | Examples |
---|---|---|---|
cics.transaction.class_name | string | experimental The name of the transaction class of this transaction. | null ; DFHTCL00 |
cics.transaction.client.ip | ipAddress | experimental IP address of the client (IPv4 or IPv6) that made the request that triggered the transaction. | 194.232.104.141 ; 2a01:468:1000:9::140 |
cics.transaction.client.port | long | experimental Port number of the client that made the request that triggered the transaction. | 65123 ; 80 |
cics.transaction.path.name | string | experimental The path name, only applicable for web requests. | /dtrouter |
cics.transaction.task_id | long | experimental The CICS task ID of this transaction. | 1234 |
cics.transaction.transaction_group_id | string | experimental The transaction group ID assigned at transaction attach time. | 160dd5c5e3c44bc8e5c5c1c3f4f4f9df9fa2d8b049cb800000000000 |
cics.transaction.unit_of_work_id | long | experimental The unit of work ID for this transaction, which is normally represented as a hex value. | 15977055984148641282 ; 15977055491352760323 |
cics.transaction.user_id | string | experimental The user ID of the user who triggered this transaction. | USER1 ; anon |
cics.transaction.wlm.reporting_service_class_name | string | experimental The name of the z/OS Workload Manager (WLM) reporting service class of this transaction. | null ; BAT_ATM ; RC_CICS |
cics.transaction.wlm.service_class_name | string | experimental The name of the z/OS Workload Manager (WLM) service class of this transaction. | null ; SYSSTC ; VEL15I5 |
Attribute | Type | Description | Examples |
---|---|---|---|
cics.file.defining_region_name | string | experimental The system ID of the CICS region that is defined on the request. | C259 ; CICS |
cics.file.is_local | boolean | experimental A boolean that is true if the file is defined within the CICS region that it executed in. | true |
cics.file_name | string | experimental The logical name of the file, as defined in CEDA. | EXMPCAT ; CICSFILE |
Attribute | Type | Description | Examples |
---|---|---|---|
ims.message.transaction.message.segment_count | long | experimental The number of segments in the message. | 1 ; 5 |
ims.message.transaction.message.size | long | experimental The size of the message. | 10 ; 421 |
ims.message.transaction.terminal_name | string | experimental The terminal name that this IMS transaction executed on. | HWSAM5ZD ; 10505 |
ims.message.transaction.unit_of_work_id | long | experimental The unit of work ID for this transaction, which is normally represented as a hex value. | 5981228500318430862871015129591113287966852300630664295044916520394057871645605888 ; 5981112713529734741010744557477214433959078921583025076794253743298954785382793216 |
ims.message.transaction.user_id | string | experimental The user ID of the user who triggered this transaction. | USER1 ; anon |
Attribute | Type | Description | Examples |
---|---|---|---|
ims.execution.transaction.commit_count | long | experimental The commit count for this transaction. | 4 ; 5 |
ims.execution.transaction.current_priority | long | experimental The current priority of this transaction. | 1 ; 5 |
ims.execution.transaction.execution_class | long | experimental The execution class of this transaction. | 45 ; 66 |
ims.execution.transaction.psb_name | string | experimental The PSB name that this IMS transaction executed on. | HWSAM5ZD ; 10505 |
ims.execution.transaction.schedule_count | long | experimental The schedule count for this transaction. | 346613 ; 421 |
ims.execution.transaction.unit_of_work_id | long | experimental The unit of work ID for this transaction, which is normally represented as a hex value. | 5981228500318430862871015129591113287966852300630664295044916520394057871645605888 ; 5981112713529734741010744557477214433959078921583025076794253743298954785382793216 |
Attribute | Type | Description | Examples |
---|---|---|---|
ims.connect.transaction.client.ip | ipAddress | experimental IP address of the client (IPv4 or IPv6) that made the request that triggered the transaction. | 194.232.104.141 ; 2a01:468:1000:9::140 |
ims.connect.transaction.server.port | long | experimental Port number on the IMS Connect server that received the request for this transaction | 65123 ; 80 |
ims.connect.transaction.user_id | string | experimental The user ID of the user who triggered this transaction. | USER1 ; anon |
Attribute | Type | Description | Examples |
---|---|---|---|
ims.tm.resource.adapter.semantic_detection_version | string | experimental The detection version for this transaction. | 1 |
ims.tm.resource.adapter.transaction.client.ip | ipAddress | experimental IP address of the client (IPv4 or IPv6) that made the request that triggered the transaction. | 194.232.104.141 ; 2a01:468:1000:9::140 |
ims.tm.resource.adapter.transaction.client.port | long | experimental Port number of the client that made the request that triggered the transaction. | 65123 ; 80 |
ims.tm.resource.adapter.transaction.commit_mode | long | experimental The commit mode of the transaction. | 0 |
ims.tm.resource.adapter.transaction.datastore_name | string | experimental The datastore name used by this transaction. | IMS1500 |
ims.tm.resource.adapter.transaction.interaction_verb | long | experimental The interaction verb that triggered the transaction. | 0 |
ims.tm.resource.adapter.transaction.lpar_name | string | experimental The name of the LPAR that the transaction executed on. | S0W1 ; ABCD |
ims.tm.resource.adapter.transaction.sync_level | long | experimental Indicates the synchronization level of the transaction. This only applies when the interaction verb is set to "SYNC_SEND_RECEIVE", "SYNC_SEND", or "SYNC_RECEIVE_CALLOUT". This attribute applies to both conversational and non-conversational applications. It is used in conjuction with the ims.transaction.request.transaction.commit_mode attribute. | 0 |
ims.tm.resource.adapter.transaction.commit_mode
MUST be one of the following:
Value | Description |
---|---|
0 | The commit happens before sending the response. |
1 | The commit is deferred until the response has been sent and acknowledged. |
ims.tm.resource.adapter.transaction.interaction_verb
MUST be one of the following:
Value | Description |
---|---|
0 | SYNC_SEND |
1 | SYNC_SEND_RECEIVE |
3 | SYNC_END_CONVERSATION |
4 | SYNC_RECEIVE_ASYNCOUTPUT |
5 | SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT |
6 | SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT |
7 | SYNC_RECEIVE_CALLOUT |
ims.tm.resource.adapter.transaction.sync_level
MUST be one of the following:
Value | Description |
---|---|
0 | There will be no synchronization. |
1 | Synchronization will be confirmed. |
Attribute | Type | Description | Examples |
---|---|---|---|
zosconnect.api.description | string | experimental The z/OS Connect API description. | The API for the CICS catalog manager sample application. |
zosconnect.api.name | string | experimental The z/OS Connect API name. | catalog |
zosconnect.api.version | string | experimental The z/OS Connect API version. | 1.0.0 |
zosconnect.request.body.size | long | experimental The size of the request payload in bytes. | 234 |
zosconnect.request.id | long | experimental The z/OS Connect request ID. | 2215 |
zosconnect.request.type | string | experimental The type of the REST request. 1 | ADMIN |
zosconnect.response.body.size | long | experimental The size of the response payload in bytes. | 125 |
zosconnect.service.description | string | experimental The z/OS Connect service description. | EDUCHAN service using the CICS Service Provider |
zosconnect.service.name | string | experimental The z/OS Connect service name. | placeOrder |
zosconnect.service.provider.name | string | experimental The service provider name. | CICS-1.0 |
zosconnect.service.version | string | experimental The z/OS Connect service version. | 2.0 |
zosconnect.sor.identifier | string | experimental The system of record identifier. The format differs depending on the SOR type. 2 | localhost:8080 |
zosconnect.sor.reference | string | experimental The system of record reference. | cicsConn |
zosconnect.sor.resource | string | experimental Identifier for the resource invoked on the system of record. The format differs depending on the SOR type. 3 | 01,DFH0XCMN |
zosconnect.sor.type | string | experimental The system of record type. | CICS |
zosconnect.request.type
MUST be one of the following:
Value | Description |
---|---|
ADMIN | admin |
API | api |
SERVICE | service |
UNKNOWN | unknown |
zosconnect.sor.type
MUST be one of the following:
Value | Description |
---|---|
CICS | cics |
IMS | ims |
MQ | mq |
REST | rest |
WOLA | wola |