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.songexample.xyz"),
trace.WithBatchTimeout(2 * time.Second),
trace.WithCompression(trace.CompressorZstd),
)
}
2. Endpoint Specification
| Endpoint | Transport | Authentication | Description |
|---|---|---|---|
GET / | HTTPS (H2) | Public | SDK reference manual and schema index |
POST /v2/clock/sync | HTTP/2 Stream | Bearer Token | Monotonic clock offset calibration & span flush |
GET /api/stream | WebSocket (WSS) | Session Token | Live tailing of sampled trace graphs |