trustkit 0.1.0

OpenTelemetry + Traceloop initialization helper for Python services

trustkit (Python)

OpenTelemetry + Traceloop initialization helper for Python services.

Installation

pip install trustkit

Usage

from trustkit import init_otel

init_otel(
    endpoint="https://your-otel-collector.example.com",
    api_key="your-api-key",
    service_name="my-service",
)

The endpoint is automatically normalized — /api/otel/traces is appended if not already present.

If the OTLP endpoint is unreachable, init_otel(...) falls back to a no-op exporter and the app continues running without traces.

Parameters

Parameter	Type	Description
endpoint	str	OTLP HTTP base URL (e.g. https://collector.example.com)
api_key	str	Value for the X-API-Key header
service_name	str	Service name shown in traces

Optional Environment Variables

All of these are optional — sensible defaults are baked in.

Variable	Default	Description
OTEL_SERVICE_VERSION	0.0.0-local	Service version shown in traces
OTEL_DEPLOYMENT_ENVIRONMENT	local-workstation	Deployment environment
OTEL_SERVICE_INSTANCE_ID	local-instance	Instance ID
OTEL_EXPORTER_OTLP_COMPRESSION	gzip	Compression (gzip or none)
OTEL_EXPORTER_OTLP_PROTOCOL	http/protobuf	Protocol

License

Copyright © BRANDAD Development GmbH. All rights reserved.

This library is licensed under the PolyForm Shield License 1.0.0.