Struct TelemetryConfig 

pub struct TelemetryConfig {
    pub service_name: String,
    pub service_version: String,
    pub log_level: String,
    pub json_logs: bool,
    pub stderr_output: bool,
    pub otlp_endpoint: Option<String>,
    pub otlp_protocol: OtlpProtocol,
    pub sampling_ratio: f64,
    pub export_timeout: Duration,
    pub prometheus_port: Option<u16>,
    pub prometheus_path: String,
    pub resource_attributes: Vec<(String, String)>,
}

Telemetry configuration

Use TelemetryConfigBuilder for ergonomic configuration construction.

Example

use turbomcp_telemetry::TelemetryConfig;

let config = TelemetryConfig::builder()
    .service_name("my-mcp-server")
    .service_version("1.0.0")
    .log_level("info,turbomcp=debug")
    .build();

Fields

service_name: String

Service name for telemetry identification

service_version: String

Service version

log_level: String

Log level filter (e.g., “info”, “debug”, “info,turbomcp=debug”)

json_logs: bool

Enable JSON-formatted log output

stderr_output: bool

Output logs to stderr (required for STDIO transport)

otlp_endpoint: Option<String>

Available on crate feature opentelemetry only.

OpenTelemetry OTLP endpoint (e.g., “http://localhost:4317”)

otlp_protocol: OtlpProtocol

Available on crate feature opentelemetry only.

OTLP protocol (grpc or http)

sampling_ratio: f64

Available on crate feature opentelemetry only.

Trace sampling ratio (0.0 to 1.0)

export_timeout: Duration

Available on crate feature opentelemetry only.

Export timeout

prometheus_port: Option<u16>

Available on crate feature prometheus only.

Prometheus metrics endpoint port

prometheus_path: String

Available on crate feature prometheus only.

Prometheus metrics endpoint path

resource_attributes: Vec<(String, String)>

Additional resource attributes

Implementations

impl TelemetryConfig

pub fn builder() -> TelemetryConfigBuilder

Create a new configuration builder

pub fn init(self) -> Result<TelemetryGuard, TelemetryError>

Initialize telemetry with this configuration

Returns a guard that ensures proper cleanup on drop.

Trait Implementations

impl Clone for TelemetryConfig

fn clone(&self) -> TelemetryConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TelemetryConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TelemetryConfig

fn default() -> Self

Returns the “default value” for a type.