APM Spans

This dataset represents APM span data collected by Datadog Application Performance Monitoring. Spans represent individual units of work within distributed traces, capturing timing, resource usage, and error information. This enables analysis of service dependencies, latency issues, error rates, and overall application performance across your distributed systems.

dd.spans

APM Public Documentation

Trace Explorer Documentation

Span Tags and Attributes Documentation

Fields

TitleIDTypeData TypeDescription
TimestamptimestampcoretimestampTime the span started. Applies to: all.
Trace IDtrace_idcorestringUnique identifier for the distributed trace. Applies to: all.
EnvironmentenvcorestringEnvironment identifier (e.g., production, staging). Applies to: all.
ServiceservicecorestringName of the service generating the span. Applies to: all.
Operation Nameoperation_namecorestringName of the operation being traced (e.g., http.request, db.query). Applies to: all.
Resource Nameresource_namecorestringSpecific resource being accessed (e.g., GET /api/users, SELECT users). Applies to: all.
StatusstatuscorestringSpan completion status (ok, error). Applies to: all.
Ingestion Reasoningestion_reasoncorestringWhy the span was ingested (e.g., auto, manual, sampling). Applies to: all.
Span IDspan_idcorestringUnique identifier for this span. Applies to: all.
Parent Span IDparent_idcorestringID of the parent span (empty for root spans). Applies to: all.
Duration@durationevent_attributeint64Duration of the span in nanoseconds. Applies to: all.
Span Kind@span.kindevent_attributestringType of span (server, client, producer, consumer, internal). Applies to: all.
Version@versionevent_attributestringVersion of the service generating the span. Applies to: all.
Language@languageevent_attributestringProgramming language of the client SDK (go, java, python, etc.). Applies to: all.
Component@componentevent_attributestringComponent or library generating the span. Applies to: all.
Error@errorevent_attributeint64Whether an error occurred (0 or 1). Applies to: all.
Error Message@error.messageevent_attributestringError message text. Applies to: error spans.
Error Type@error.typeevent_attributestringType or class of the error. Applies to: error spans.
Error Stack@error.stackevent_attributestringStack trace for the error. Applies to: error spans.
HTTP Method@http.methodevent_attributestringHTTP method (GET, POST, PUT, etc.). Applies to: HTTP spans.
HTTP Status Code@http.status_codeevent_attributeint64HTTP response status code. Applies to: HTTP spans.
HTTP URL@http.urlevent_attributestringFull URL of the HTTP request. Applies to: HTTP spans.
HTTP Route@http.routeevent_attributestringParameterized route pattern (e.g., /users/:id). Applies to: HTTP spans.
HTTP User Agent@http.useragentevent_attributestringUser agent string from the request. Applies to: HTTP spans.
HTTP Request Content Length@http.request.content_lengthevent_attributeint64Size of the HTTP request body in bytes. Applies to: HTTP spans.
HTTP Response Content Length@http.response.content_lengthevent_attributeint64Size of the HTTP response body in bytes. Applies to: HTTP spans.
Database System@db.systemevent_attributestringDatabase system type (postgresql, mysql, mongodb, redis, etc.). Applies to: database spans.
Database Operation@db.operationevent_attributestringDatabase operation performed (SELECT, INSERT, UPDATE, DELETE). Applies to: database spans.
Database Table@db.sql.tableevent_attributestringName of the database table being accessed. Applies to: database spans.
Database Statement@db.statementevent_attributestringDatabase statement or query text. Applies to: database spans.
Database User@db.userevent_attributestringDatabase user performing the operation. Applies to: database spans.
Row Count@db.row_countevent_attributeint64Number of rows affected or returned. Applies to: database spans.
Peer Service@peer.serviceevent_attributestringName of the remote service being called. Applies to: client spans.
Peer Hostname@peer.hostnameevent_attributestringHostname of the remote peer. Applies to: client spans.
Peer Port@peer.portevent_attributeint64Port of the remote peer. Applies to: client spans.
Client IP@network.client.ipevent_attributestringIP address of the client. Applies to: server spans.
Messaging System@messaging.systemevent_attributestringMessaging system type (kafka, rabbitmq, sqs, etc.). Applies to: messaging spans.
Messaging Destination@messaging.destinationevent_attributestringTopic or queue name. Applies to: messaging spans.
Messaging Operation@messaging.operationevent_attributestringMessaging operation (publish, receive, process). Applies to: messaging spans.
Host@hostevent_attributestringHostname where the span was generated. Applies to: all.
Container ID@container_idevent_attributestringContainer ID where the span was generated. Applies to: containerized services.
Container Name@container_nameevent_attributestringContainer name where the span was generated. Applies to: containerized services.
Pod Name@pod_nameevent_attributestringKubernetes pod name. Applies to: Kubernetes services.
User ID@usr.idevent_attributestringUnique identifier for the user. Applies to: all.
User Email@usr.emailevent_attributestringEmail address of the user. Applies to: all.
RPC System@rpc.systemevent_attributestringRPC system type (grpc). Applies to: gRPC spans.
RPC Service@rpc.serviceevent_attributestringName of the RPC service being called. Applies to: gRPC spans.
RPC Method@rpc.methodevent_attributestringName of the RPC method being called. Applies to: gRPC spans.
gRPC Status Code@rpc.grpc.status_codeevent_attributeint64gRPC status code. Applies to: gRPC spans.