Identity
| Parameter | Description |
|---|
traceId | Unique identifier of the trace |
spanId | Unique identifier of the span within a trace |
parentSpanId | ID of the parent span. Identifies the caller in a parent-child span relationship |
spanName | Name of the span |
serviceName | Name of the service that generated the span. Used for multitenancy |
Timing
| Parameter | Description |
|---|
startTime | Span start time, in nanoseconds |
duration | Span duration, in nanoseconds |
Status
| Parameter | Description |
|---|
statusCode | Status of the span. See statusCode values below |
statusMessage | Human-readable message that describes the status code |
statusCode values
| Value | Constant | Meaning |
|---|
| 0 | STATUS_CODE_UNSET | The span is not configured |
| 1 | STATUS_CODE_OK | The span is running as expected |
| 2 | STATUS_CODE_ERROR | A span error has occurred |
Classification
| Parameter | Description |
|---|
kind | Role of the span in a distributed trace, as defined by the OpenTelemetry SpanKind specification. See kind values below |
serviceType | Numeric identifier of the framework or component that generated the span. See serviceType values below |
kind values
The kind parameter classifies the role of a span in a distributed trace, distinguishing between incoming requests, outgoing calls, and asynchronous messaging.
| Value | Constant | Meaning |
|---|
| 0 | SPAN_KIND_UNSPECIFIED | Default value when no kind is set |
| 1 | SPAN_KIND_INTERNAL | Internal operation within a service, such as a function call |
| 2 | SPAN_KIND_SERVER | Server-side handling of a synchronous request, such as an HTTP or RPC server |
| 3 | SPAN_KIND_CLIENT | Client-side of a synchronous request to a remote service |
| 4 | SPAN_KIND_PRODUCER | Sender in an asynchronous messaging system, such as a message queue producer |
| 5 | SPAN_KIND_CONSUMER | Receiver in an asynchronous messaging system, such as a message queue consumer |
For the full specification, see OpenTelemetry SpanKind.
Infrastructure
| Parameter | Description |
|---|
hostname | Hostname of the machine that generated the span |
ip | IP address of the host |
Payload
| Parameter | Description |
|---|
attributes | Indexed key-value pairs attached to the span for filtering and querying |
resources | Resource metadata about the span, such as the process ID and Java Virtual Machine (JVM) version |
event | Event recorded during the span lifecycle. Contains unindexed fields such as timestamp, name, and attribute |
links | Links from the current span to one or more spans in the same or different traces |
serviceType values
The serviceType parameter identifies the framework or component that generated a span. Use these numeric codes to filter traces by technology stack.
Web servers and application servers
| Value | Framework |
|---|
| 1010 | Tomcat |
| 1030 | Jetty Server |
| 1040 | Akka HTTP |
| 1060 | WebSphere |
| 1080 | WebLogic |
| 1090 | Undertow |
RPC frameworks
| Value | Framework |
|---|
| 1101 | gRPC Server |
| 9101 | gRPC Client |
| 1110 | Dubbo Provider |
| 9110 | Dubbo Consumer |
| 1111 | HSF Provider |
| 9111 | HSF Consumer |
Scheduled tasks
| Value | Framework |
|---|
| 1301 | SchedulerX |
| 1302 | XXL-JOB |
| 1303 | Spring Scheduled |
| 1304 | Quartz |
| 1305 | ElasticJob |
Databases
| Value | Database |
|---|
| 2100 | MySQL |
| 2150 | MariaDB |
| 2300 | Oracle |
| 2500 | PostgreSQL |
| 2510 | PPAS |
| 2520 | SQL Server |
| 2650 | MongoDB |
| 2700 | OceanBase |
| 2780 | ClickHouse |
| 2800 | InfluxDB |
| 2900 | Cassandra |
| 2910 | Lindorm |
Web frameworks and ORM
| Value | Framework |
|---|
| 5053 | Spring Webflux |
| 5510 | MyBatis |
Connection pools
| Value | Framework |
|---|
| 6060 | HikariCP |
| 6062 | Druid |
Search engines
| Value | Engine |
|---|
| 72 | Elasticsearch |
Cache and Redis clients
| Value | Client |
|---|
| 8050 | Memcached |
| 8200 | Jedis |
| 8201 | Lettuce |
| 8203 | Redisson |
Message queues
| Value | Framework |
|---|
| 8410 | RocketMQ Producer |
| 8420 | RocketMQ Consumer |
| 8660 | Kafka Producer |
| 8670 | Kafka Consumer |
HTTP clients
| Value | Client |
|---|
| 1035 | Jetty Client |
| 1142 | Reactor Netty HTTP Client |
| 9050 | Apache HTTP Client 3 |
| 9052 | Apache HTTP Client 4 |
| 9054 | Google HTTP Client |
| 9055 | JDK HttpURLConnection |
| 9056 | AsyncHttpClient |
| 9058 | OkHttpClient |
| 9130 | Vertx HTTP Client |
| 9153 | Spring Webflux Client |
Network frameworks
| Value | Framework |
|---|
| 9150 | Netty |
| 9151 | Netty Client |