Distributed Tracing SDK & Span Ingestion Reference

VeloceTrace provides deterministic, sub-millisecond distributed context propagation and monotonic clock synchronization for high-throughput microservices. All ingestion endpoints require TLS 1.3 and valid HMAC bearer credentials.

1. Initializing the Go Exporter

package main

import (
    "context"
    "time"
    "go.velocetrace.io/sdk/trace"
)

func initTracer(ctx context.Context) (*trace.Provider, error) {
    return trace.NewProvider(
        trace.WithEndpoint("https://docs.4327657.xyz"),
        trace.WithBatchTimeout(2 * time.Second),
        trace.WithCompression(trace.CompressorZstd),
    )
}

2. Endpoint Specification

EndpointTransportAuthenticationDescription
GET /HTTPS (H2)PublicSDK reference manual and schema index
POST /v2/clock/syncHTTP/2 StreamBearer TokenMonotonic clock offset calibration & span flush
GET /api/streamWebSocket (WSS)Session TokenLive tailing of sampled trace graphs