New Relic · Schema

ZipkinSpan

A single span in Zipkin JSON v2 format

AnalysisAnalyticsAPMDevOpsInfrastructureMonitoringObservabilityPerformancePlatform

Properties

Name	Type	Description
id	string	Span ID (16 hex characters)
traceId	string	Trace ID (32 hex characters)
parentId	string	Parent span ID
name	string	Span name / operation name
timestamp	integer	Span start time in microseconds since epoch
duration	integer	Span duration in microseconds
kind	string
localEndpoint	object
remoteEndpoint	object
tags	object
annotations	array

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/new-relic/refs/heads/main/json-schema/trace-api-zipkin-span-schema.json",
  "title": "ZipkinSpan",
  "description": "A single span in Zipkin JSON v2 format",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Span ID (16 hex characters)",
      "example": "500123"
    },
    "traceId": {
      "type": "string",
      "description": "Trace ID (32 hex characters)",
      "example": "500123"
    },
    "parentId": {
      "type": "string",
      "description": "Parent span ID",
      "example": "500123"
    },
    "name": {
      "type": "string",
      "description": "Span name / operation name",
      "example": "example-resource-01"
    },
    "timestamp": {
      "type": "integer",
      "description": "Span start time in microseconds since epoch",
      "example": 1718153645993
    },
    "duration": {
      "type": "integer",
      "description": "Span duration in microseconds",
      "example": 100
    },
    "kind": {
      "type": "string",
      "enum": [
        "CLIENT",
        "SERVER",
        "PRODUCER",
        "CONSUMER"
      ],
      "example": "CLIENT"
    },
    "localEndpoint": {
      "type": "object",
      "properties": {
        "serviceName": {
          "type": "string"
        },
        "ipv4": {
          "type": "string"
        },
        "port": {
          "type": "integer"
        }
      },
      "example": {
        "serviceName": "myService",
        "ipv4": "example_string",
        "port": 8080
      }
    },
    "remoteEndpoint": {
      "type": "object",
      "properties": {
        "serviceName": {
          "type": "string"
        },
        "ipv4": {
          "type": "string"
        },
        "port": {
          "type": "integer"
        }
      },
      "example": {
        "serviceName": "myService",
        "ipv4": "example_string",
        "port": 8080
      }
    },
    "tags": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "example": {
        "customAttribute": "example_value"
      }
    },
    "annotations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "timestamp": {
            "type": "integer"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "example": [
        {
          "timestamp": 1718153645993,
          "value": "example_string"
        }
      ]
    }
  },
  "required": [
    "id",
    "traceId"
  ]
}