How can we help your Engineering Team?

Explore step-by-step SDK guides, W3C trace context standards, environment variables, and configuration blueprints for sovereign cloud environments.

Quickstart SDK Installation

Install binary agents or lightweight middleware packages in under 2 minutes.

OpenTelemetry v1.28+ Compatible

Go SDK Quickstart

Backend

Integrate into Gin, Fiber, Chi, or net/http with zero-overhead asynchronous batching.

go get github.com/trustport/beacon-go

Production readyRead Full Go Guide

Node.js & NestJS SDK

TypeScript

Automatic middleware interception for Express, Fastify, and NestJS interceptors.

npm install @trustport/beacon-node

Production readyRead Full Node.js Setup

Python & FastAPI SDK

Python 3.10+

ASGI & WSGI automatic trace injection with SQLAlchemy query timing hooks.

pip install trustport-beacon

Production readyRead Full Python Docs

Docker & Kubernetes Sidecar

DevOps

DaemonSet agent collecting eBPF socket events and container metrics without code changes.

helm repo add trustport https://charts.trustportidentity.com

Production readyRead Full Helm Setup

Complete SDK Integration Blueprints

Select your runtime to inspect production-ready initialization code.

main.go

package main

import (
    "github.com/gin-gonic/gin"
    "github.com/trustport/beacon-go"
)

func main() {
    // Initialize TrustPort Beacon SDK
    beacon.Init(beacon.Config{
        IngestURL:   "http://localhost:8443", // Or UK-1 Sovereign Endpoint
        APIKey:      "tp_live_9f8a3c4e12",
        ServiceName: "payment-service",
        Environment: "production",
    })
    defer beacon.Close()

    r := gin.Default()

    // Attach automatic W3C traceparent middleware
    r.Use(beacon.GinMiddleware("payment-service"))

    r.POST("/api/v1/charge", func(c *gin.Context) {
        ctx := c.Request.Context()
        
        // Record custom trace span for database query
        span := beacon.StartSpan(ctx, "db.query.charge_account")
        defer span.End()

        c.JSON(200, gin.H{"status": "charged", "trace_id": beacon.TraceID(ctx)})
    })

    r.Run(":8080")
}

Standard Compliance

W3C Trace Context Specification

TrustPort Beacon strictly adheres to the official W3C Distributed Tracing recommendation. Spans are connected via the universal traceparent header across every network hop.

# W3C Header Format:version-trace_id (32 hex)-parent_id (16 hex)-trace_flags

# Live Ingestion Header Example:traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

Zero vendor lock-in

OpenTelemetry native

Environment Variables Reference

BEACON_INGEST_URL

URL of your sovereign ingestion node: http://localhost:8443 or UK-1 cluster endpoint.

BEACON_API_KEY

Cryptographic ingest token (begins with tp_live_...).

BEACON_SERVICE_NAME

Canonical microservice identifier (e.g., api-gateway, auth-service).

BEACON_ENVIRONMENT

Deployment environment tag (production, staging).

Frequently Asked Developer Questions

Technical answers regarding eBPF overhead, ring buffer fallback, and air-gapped deployments.

The TrustPort eBPF agent runs directly inside the Linux kernel to intercept socket calls (connect, accept, read, write) without modifying application source binaries. This achieves nanosecond-level latency measurement with less than 0.8% CPU footprint.

Need hands-on deployment support?

Our sovereign engineering support team is available 24/7 to assist with cluster installations, air-gapped deployments, and custom OpenTelemetry collectors.

Open a Sovereign Support Ticket Launch Live Console