Trace and Span Attributes for Enrichment
The trace (root span) and span attributes in Trace Explorer are defined by tagging a span, which enable the effective monitoring of the various tiers of an application.
Attributes are key-value pairs attached to a span to provide additional information and context about the operation performed in the span. A trace has some trace only attributes as well as all the span attributes of the root span.
In Trace Explorer, you can use attributes to query and filter traces and spans. There are two types of attributes: Dimensions (string attributes) and Metrics (numeric attributes) which are available in the Attributes panel in Trace Explorer.
This section provides a complete list of attributes applicable to enrichment. The below table includes:
- Name: Name of the attribute.
- Description: Brief description of the attribute.
- Trace/Span: Availability of the attribute. A attribute can be available for traces, spans, or both.
- Type: Type of attribute: Dimension or Metric.
| Name | Description | Trace/Span | Type |
|---|---|---|---|
ApdexLevel |
The level of user satisfaction:
Satisfied, Tolerating or
Frustrated.
|
Trace and span attribute | Dimension |
BrowserName |
The name of the web browser derived from the user agent.
For example: Chrome.
|
Trace and span attribute | Dimension |
BrowserVersion |
The version of the browser. | Trace and span attribute | Dimension |
ClientIpThreatConfidence |
The overall confidence of the threat(s) from one threat indicator (IP address). |
Span attribute | Metric |
ClientIpThreatType |
The threat type.
See Threat Indicator Database Threat Types from Threat Intelligence. |
Span attribute | Dimension |
EndTime |
The end time of the span. | Span attribute | Metric |
ErrorCount |
The number of spans that are marked as failed (Error =
true). It's possible that multiple spans in a
single trace are marked failed, in which case this number will be the
count of the failed spans.
|
Trace and span attribute | Metric |
FrustratedPageViews |
The number of page views with a 'frustrating' performance. | Trace and span attribute | Metric |
GeoCity |
The city where the browser agent originated. Foot 1 | Trace and span attribute | Dimension |
GeoContinentCode |
The continent where the browser agent originated. Foot 1 | Trace and span attribute | Dimension |
GeoCoordLatitude |
The latitude where the browser agent originated.Foot 1 | Trace and span attribute | Dimension |
GeoCoordLongitude |
The longitude where the browser agent originated. Foot 1 | Trace and span attribute | Dimension |
GeoCountry |
The country where the browser agent originated. Foot 1 | Trace and span attribute | Dimension |
GeoCountryCode |
The ISO 3166-based country code where the browser agent originated. Foot 1 | Trace and span attribute | Dimension |
GeoInternetServiceProvider |
The ISP where the browser agent originated. Foot 1 | Trace and span attribute | Dimension |
GeoRegionCode |
The ISO 3611-based region code where the browser agent originated. Foot 1 | Trace and span attribute | Dimension |
ReportPeriod |
The time the span information was received by the service collector. It can be used as normalized end time in cases when the monitored component's clocks are not synchronized. | Trace and span attribute | Metric |
SpanCount |
The number of spans that have been processed by the system for the trace. | Trace attribute | Metric |
SpanDuration |
The duration of the span. | Span attribute | Metric |
SpanErrorCount |
A numeric representation of the Boolean Error attribute,
which can be 1 or 0.
|
Trace and span attribute | Metric |
TraceDuration |
The duration of time between the start of the earliest span and the end of the most recent span in milliseconds. | Trace attribute | Metric |
TraceErrorCode |
The error code of the trace. | Trace attribute | Dimension |
TraceErrorType |
The type of trace error. | Trace attribute | Dimension |
TraceFirstSpanStartTime |
The start time of the first span in the trace. This is recorded in local agent time in UTC. | Trace attribute | Metric |
TraceId |
The ID of the trace. | Trace and span attribute | Dimension |
TraceLatestSpanEndTime |
The sum of the latest recorded start time and the duration of a span in the trace. This is recorded in local agent time in UTC. | Trace attribute | Metric |
TraceLatestSpanStartTime |
The start time of the span in relation to the latest span end time. This can be used to find out the critical path in performance. | Trace attribute | Metric |
TraceRootSpanDuration |
The recorded duration of the root-span of the trace. | Trace attribute | Metric |
TraceRootSpanEndTime |
The sum of the recorded start time and the duration of the root-span in the trace. This is recorded in local agent time in UTC. | Trace attribute | Metric |
TraceRootSpanErrorCount |
The SpanErrorCount of the root span,
which is always the same as the SpanErrorCount in a
trace query.
|
Trace attribute | Metric |
TraceRootSpanStartTime |
The recorded start time of the root-span of the trace. This is recorded in local agent time in UTC. | Trace attribute | Metric |
TraceStatus |
The status of the trace, which can be one of the
following:
|
Trace attribute | Dimension |
Footnote Legend
Footnote 1: Thegeo- dimension values are
added based on the APM Browser agent provided client-ip, which is either contained
in an X-Forwarded-For (XFF) HTTP header or is just an attribute of the network
connection to the collector.